Gemini Decisions API 是 Google 為「選項有限的判斷題」設計的 Gemini API 端點,搭配模型 gemini-decision-1,回傳的是各個答案的機率與信心值,而不是一段生成的文字。
把大型語言模型(LLM)接進產品時,有不少工作的答案其實都落在幾個固定選項裡:判斷一則留言是否違規、決定要把問題交給哪個模型、替一段檢索結果打分數。本文整理這個 API 的題型、價格、限制與呼叫方式;價格與限制可能調整,請以官方文件與價格頁為準。
Gemini Decisions API 是什麼、解決什麼問題
官方的定位是「選項有限的快速判斷」(closed-set decisions)。適用場景包含選擇要呼叫哪個工具、檢查內容是否符合政策、把請求分派給合適的模型,以及評估檢索到的內容與問題有多相關。
和一般文字生成最大的差別,在於它不產生文字答案。官方文件說明,這個 API 輸出的文字 token 為 0,因此輸出 token 用量永遠是 0;官方公告則說明模型以單次前向傳遞(forward pass)替候選答案計分。
每個答案都附一個 0 到 1 的信心值(confidence)。程式可以用這個數字分流:信心夠高就直接採用,信心偏低就轉給備援模型或真人審核。
補充說明:以聊天模型做分類時,輸出格式要自己解析;這個 API 的答案本身就是結構化的機率欄位。實際準確度仍取決於你的資料與題目寫法,官方的基準測試數字只能參考。
案例:官方公佈的發表背景與內部用法
Google 在 2026 年 11 月 11 日發表這個 API,並提到幾個內部使用案例:
- Gemini Notebook 用它把查詢分派給合適的模型與思考程度,官方稱一般查詢的延遲最多降低 40%。
- Google 搜尋把它當作安全層,偵測 MCP 工具中的惡意行為。
這些都是 Google 自己的說法,外部尚無獨立驗證。官方公告同時列出的整合對象(OpenRouter、LangChain、Vercel、LiteLLM、Pydantic AI、Pipecat、LiveKit、OpenCode)屬於公告當時的「陸續上線」狀態,是否已可用請查各專案文件。
功能與規格
三種題型
官方文件把問題分成三類,一次請求可以對同一份輸入問多題。每題都要有 type 與 instructions,choice 與 score 另外要有 criteria。
| 題型 | 用途 | 回傳內容 |
|---|---|---|
noul | 是非題,回傳「是」的機率(0.01 到 0.99) | noul、confidence |
choice | 從固定清單選一項,2 到 255 個選項 | choice、probabilities、confidence |
score | 依分級評分,2 到 255 級(文件建議 2 到 10 級) | score、legend、probabilities、confidence |
是非題的型別名稱是 noul,不是常見的 boolean,寫程式時要留意。
輸入可以混合文字、圖片、音訊、影片與 PDF。JSON 要先序列化成字串,當文字傳入。
價格
價格依 Google AI Studio 價格頁,查詢日期 2026-11-19;價格可能調整,請以官方價格頁為準。
| 項目 | 免費層 | 付費層 |
|---|---|---|
| 輸入(文字、圖片、影片、音訊、PDF) | 免費 | 每 100 萬 token 0.10 美元 |
| 輸出 | 0 輸出 token,不計費 | 0 輸出 token,不計費 |
| 內容用於改善 Google 產品 | 是 | 否 |
計費上,同一份共用輸入在一次請求只算一次,不論問了幾題。
資料來源:Gemini API 價格頁、Decisions API 文件。
官方公告另稱,在其內部基準測試組合上,成本約為 Interactions API 搭配 Gemini 3.5 Flash-Lite 的接近五分之一(官方寫 nearly 5x cheaper)。這是 Google 自己選的比較條件,沒有獨立驗證。
請求限制
| 項目 | 限制 |
|---|---|
| 單次請求問題數 | 1 到 1,000 題 |
| 內容視窗 | 262,144 token(輸入與所有問題共用) |
| 內嵌資料 | 每次請求最多 100 MB,PDF 為 50 MB |
| 外部 URL | 每個最多 15 MB |
| 問題 key | 1 到 64 個 ASCII 字元,限 [A-Za-z0-9_-] |
官方公告稱端到端延遲約 150 到 250 毫秒,且適用範圍是內容在 16K token 以內;這是官方數字,實際延遲請以自己的環境量測。速率限制的數值,文件指向 Rate limits 頁的 Gemini Decision 小節,請直接查該頁。
目前不支援的功能
文件列出的限制包含:
- 問題的指示只接受文字,不能放媒體。
- 不支援 YouTube 網址與
gs://路徑。 - 不支援 context caching、Batch API,以及 Flex 或 Priority 推論。
- 不接受思考、工具呼叫與對話歷史區塊當輸入。
- 只支援
gemini-decision-1與v1beta這個 API 版本。
被輸入安全過濾器擋下的請求,API 會回傳 HTTP 400 與錯誤物件,而不是 answers。
可用平台
文件指出,這個 API 目前只在 Gemini Developer API 的 v1beta 提供。官方公告把 Google Cloud 上的 Gemini 支援標示為「即將推出」(發表當時的說法,現況請查官方)。
我在官方文件與公告中沒有找到可用地區的說明;要確認所在地能不能用,請到 Google AI Studio 申請 API 金鑰測試。
怎麼開始用
照官方文件,流程是這樣:
- 到 Google AI Studio 取得 API 金鑰。
- 安裝 SDK,文件註明需要 3.2 以上版本。
- 建立 client 時把 API 版本設成
v1beta,呼叫client.decisions.create(...)。
下面的範例改寫自官方文件的 Python 快速入門,判斷商品是不是損壞到貨。本篇沒有執行這段程式,完整的 Python、JavaScript 與 REST 範例請以官方文件為準:
from google import genai
client = genai.Client(http_options={"api_version": "v1beta"})
result = client.decisions.create(
model="gemini-decision-1",
input="藍色馬克杯週一下單,週三送到時已經裂了。",
questions={
"is_damaged": {
"type": "noul",
"instructions": "商品是否在送達時損壞?",
},
},
)
answer = result.answers["is_damaged"]
print(f"P(yes)={answer.noul:.2f} confidence={answer.confidence:.2f}")
noul 是「是」的機率,confidence 是模型對這個答案的信心。choice 題必須提供 criteria,noul 題可選填,用來說明「是」與「否」各代表什麼。
REST 的端點是 POST https://generativelanguage.googleapis.com/v1beta/decisions,金鑰放在 x-goog-api-key 標頭。
如果你對呼叫 HTTP API 的基本概念還不熟,可以先看站內的 HTTP 請求方法,了解 POST 請求的用途。
發佈留言