跳转到主要内容
OpenAI Decisions API
通过 MixRoute 的 OpenAI 兼容 Decisions 接口,对同一份输入提出具名问题并获得结构化答案。模型使用 gpt-6-luna;此协议与 Jev System One 不同。

接入方式

POST https://api.mixroute.ai/v1/decisions 请求头使用 Authorization: Bearer $MIXROUTE_API_KEY 和 Content-Type: application/json。API Key 仅保存在服务端。模型和渠道权限取决于账户;模型出现在列表中不代表所有接口均可用。
使用 input,不是 state;questions 是可带 name 的数组,不是以问题 ID 为键的对象。真假判断用 predicate,不是 noul;分类用 choices,评分用 levels,不是 Jev 的 criteria。响应中的 answers 也是数组。Jev 协议见 System One。

请求参数

问题字段

答案类型

任何问题都可能返回 type=refusal,其他问题仍可正常返回。按 name 或问题顺序匹配,先判断 type,再读取对应字段,并显式处理拒答。置信度和概率不保证判断正确。

请求示例

调用前设置 MIXROUTE_API_KEY。示例只提交一次,不自动重试;客户端超时不代表服务端没有执行推理。

响应示例

同步返回 JSON 对象,不是 Chat Completions 的 choices 数组,也不是需要轮询的任务。概率和 token 用量会随请求变化。

结构化与图片输入

user 消息的 content 可包含 input_text(text)、input_image(image_url)、input_json(data)。JSON data 必须是对象或对象数组;其中的键仅为待判断的数据,不会触发图片抓取或创建消息。JSON 输入最多 32 层容器、10,000 个值、256 KiB 的紧凑 UTF-8 JSON。
图片使用公开 HTTP(S) URL 或 Base64 data URL,不使用 file_id。detail 可选 auto、low、high、original。developer/system 消息使用文本;assistant 消息使用输出文本或拒答项。工具结果通过 call_id 与调用匹配。此协议不接受文件、音频或条目引用。以上为协议格式,高级输入的实际可用性取决于 MixRoute 路由。 将示例图片地址替换为可公开访问的商品图片或 Base64 data URL。

可选提示词缓存

共享 input 至少达到 1,024 tokens 才具备缓存条件;questions 不属于可复用输入前缀。默认使用隐式断点;显式断点在共享 input 的文本或图片项中设置 prompt_cache_breakpoint: {"mode": "explicit"}。prompt_cache_options.mode=explicit 且没有显式断点时不使用缓存。问题 instructions 不支持缓存断点。不要将上游缓存折扣或价格直接视为 MixRoute 费率。

错误与计费

先检查 HTTP 状态。网关错误可能包含 error.message、error.type、error.code、error.param,其中 param 可能为空。排查时保留 x-oneapi-request-id,不记录完整 API Key。
结合 usage 与当前模型广场确认计费。不要假定 Responses 或 Chat Completions 的费率适用于 Decisions;实际费用取决于账户倍率和路由定价。