紀錄工作經驗、相關知識,解決技術相關問題。

時事新聞, 資訊相關

Gemini Decisions API 是什麼?gemini-decision-1 價格、限制與使用方式

Gemini Decisions API 是什麼?gemini-decision-1 價格、限制與使用方式 特色圖片

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
問題 key1 到 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 金鑰測試。

怎麼開始用

照官方文件,流程是這樣:

  1. 到 Google AI Studio 取得 API 金鑰。
  2. 安裝 SDK,文件註明需要 3.2 以上版本。
  3. 建立 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 請求的用途。

參考資料與延伸閱讀

發佈留言