跳轉到主要內容
Google Decisions API
使用 Gemini Decision 1 評估共用輸入,為每個具名問題回傳具型別的答案。本頁介紹 Google Decisions 協定,與 OpenAI Decisions 和 Jev System One 不同。 POST https://api.mixroute.ai/v1beta/decisions 傳送 Authorization: Bearer $MIXROUTE_API_KEY 和 Content-Type: application/json。使用 MixRoute Key,並儲存在伺服器端;不要將它傳送到 Google 的 API 網域。
Google 的 questions 是以問題 ID 為鍵的物件,answers 也使用對應鍵。真假判斷用 noul,選項或等級用 criteria。不要混用 OpenAI 的 questions 陣列、predicate、choices、levels,或 Jev 的 state 欄位。

請求參數

每個問題獨立評估共用輸入,無法看到其他答案。請在 instructions 中寫完整問題,再由應用程式碼組合結果。 選項 ID 為 1-128 個字元、最多 512 UTF-8 位元組;允許內部 ASCII 空格,不允許非 ASCII 空白字元。

請求示例

設定 MIXROUTE_API_KEY。Python 示例使用 requests,JavaScript 示例使用 Node.js fetch。

答案與用量

機率不保證答案一定正確。請用有標註的代表性資料設定操作門檻;信心程度低或沒有合適選項時應允許複核。
輸出 token 為 0 是正常行為:模型回傳具型別的決策,不生成文字 token。輸入仍會計費。讀取 usage.total_input_tokens、usage.total_output_tokens 和 usage.total_tokens;實際扣費以控制台消費紀錄為準。

限制與輸入格式

共用輸入與所有問題合計不得超過 262,144 tokens;JSON 巢狀深度上限為 100 層。 文字區塊使用 {"type":"text","text":"..."}。圖片、音訊、影片和 PDF document 區塊使用 type、mime_type,以及內嵌 Base64 data 或 uri。應用程式自身的 JSON 應序列化為文字字串,不要直接作為內容區塊傳送。 Google 公布的內嵌資料上限為每次 100 MB(PDF 為 50 MB),外部 HTTPS URL 為每個 15 MB。Files API URI、公開 URL 和簽署的 HTTPS URL 屬於廠商格式;經 MixRoute 上傳或取得媒體的能力取決於路由。Decisions 不支援 YouTube URL 或直接使用 gs:// URI。 相鄰文字區塊串接時不會自動加入分隔符,請自行加入空格或換行。不要傳對話訊息、思考或工具呼叫內容區塊,應將這些上下文序列化為文字。本介面不提供上下文快取、Batch API、Flex 或 Priority 推理。路由限制可能低於廠商上限。

錯誤處理

讀取 answers 前先檢查 HTTP 狀態和 JSON error 物件。參數或限制錯誤可回傳 HTTP 400;Google 安全攔截回傳錯誤而不是 answers,不能照搬 OpenAI 的逐問題 refusal 處理。也應拒絕缺少答案或答案型別不符合請求的回應。 逾時不代表請求未執行,不要盲目重試 POST。遇到限流或暫時性服務錯誤時,保留請求 ID,並依應用程式需要控制重試與退避。

相關協定

Gemini Decision 1 · OpenAI Decisions · Jev System One