跳转到主要内容
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