OpenAI 在 2026 年 10 月 22 日宣布 Decisions API 正式可用。正式版把单次请求的问题上限从公测时的 200 提升到 400,并加入共享输入缓存、问题指令中的图片,以及直接传递结构化数据的 input_json。
本文按 11 月 2 日读取的更新日志与接口指南整理。已了解公测接口的开发者,主要需要关注请求规模、输入组织和缓存统计的变化。
正式版相较公测增加了什么
| 变化 | 正式版能力 | 接入时检查 |
|---|---|---|
| 请求规模 | 单次 1—400 个问题,公测上限为 200 | 同批问题是否彼此独立 |
| 结构化输入 | input_json 直接传入对象或数组 | 放在用户消息内容中 |
| 问题内图片 | 每个问题可以有自己的图片 | 区分共同证据与问题素材 |
| 共享缓存 | 复用相同的共享输入前缀 | 前缀至少 1,024 tokens |
Decisions API 使用 gpt-6-luna,当前文档列出的支持模型只有这一项。它返回三类结果:条件为真的概率、给定选项中的选择,以及按照等级标准计算的评分。
正式版每次请求支持 1 至 400 个问题。共享证据放入 input,每个问题在 questions 中写明名称、类型和判断标准。问题名称会随答案返回,应用可以据此匹配结果。
这适合一份材料需要多项独立判断的场景,例如同一张产品图片同时判断外观损伤和商品类别。后一个判断依赖前一个结果时,官方建议拆成不同请求。
input_json 和问题图片如何组织
结构化记录可以使用 input_json 内容项,把对象或数组直接放入 data,用于用户消息中的证据输入。订单记录、支持工单和属性列表可以保留原来的数据结构。
每个问题的 instructions 也可以带自己的图片。这样,共享参考图放在 input,不同候选图放入各自的问题,同一个请求就能围绕共同参照做多项判断。
input_json 改变的是证据输入方式,输出仍按所选问题类型返回。需要抽取自定义字段并生成指定 JSON 对象的应用,可以继续评估 Responses API 的 Structured Outputs。
Decisions API 缓存哪些内容
Decisions 的缓存复用范围是匹配的共享输入前缀。默认会在共享输入末尾放置隐式缓存边界,可复用前缀至少需要 1,024 tokens;问题内容不计入这项门槛,也不属于可复用前缀。
对于固定参考材料、不断变换问题的流程,先保持参考内容一致,再查看 usage 下的 input_tokens_details:cached_tokens 记录缓存读取,cache_write_tokens 记录缓存写入。两项已经包含在 usage.input_tokens 中,计算总量时无需再把两项加回去。
官方文档给出约 10 倍于 Responses API 的速度表述。实际应用的时延和效果,需要用自己的输入与判断标准评估。本站此前的公测入门文章介绍了分类、分单与评分场景,本次正式版增加了这些输入和规模能力。
常见问题
Q: Decisions API 什么时候转为正式可用? A: API 更新日志标注为 2026 年 10 月 22 日。
Q: 一次最多能放多少问题? A: 当前上限为 400 个,公测阶段为 200 个;单次至少包含一个问题。
Q: 当前支持哪些模型?
A: 11 月 2 日读取的官方指南列出 gpt-6-luna 为当前唯一支持的模型。
Q: input_json 会让输出变成任意 JSON 吗? A: 它用于传入结构化证据,答案仍遵守 predicate、choice 或 score 的结果类型。
Q: 问题里的图片能放进共享缓存吗? A: 问题内容位于可复用前缀之外;适合多次复用的共同材料应放入共享 input。
Q: 400 个问题可以互相依赖吗? A: 同一请求适合评估共享材料上的独立问题。依赖前一个答案的后续判断,应另发请求。
来源与日期
事件或文档时间:2026-10-22。本文采集核验日期:2026 年 11 月 2 日。