简介
Decisions API 是 OpenAI 在 2026 年 10 月 6 日以公开测试版（public beta）发布的新接口，官方 changelog 写明：「Released the Decisions API in beta with gpt-6-luna. Turn text and images into typed answers 10x faster than the Responses API.」它不生成长篇文字，而是把模型的判断直接变成程序能用的「类型化答案」：某个条件成立的概率、固定选项中的一个，或者按等级打出的分数。典型用途是内容分类、请求路由、工单优先级排序、检查图片里的商品是否受损、判断检索到的段落是否相关等。 一次请求由三部分组成：model（目前只能填 gpt-6-luna）、input（作为证据的文字，或包含文字和图片的用户消息）、questions（要评估的问题数组，每个问题包含类型、说明，以及可选的选项或评分等级）。返回的 answers 数组会按每个问题的 name 一一对应。官方建议：彼此独立的问题放在同一请求里；后一个判断依赖前一个结果时分开发请求；问题要围绕可观察的标准来写，选项含义要互不重叠。如果需要按自定义 JSON Schema 生成对象或附带文字解释，官方建议改用 Responses API 的 Structured Outputs；需要调用工具时用 function calling。官方预计「未来几周」正式发布（GA）。 上手方式：升级 OpenAI SDK 到上面列出的版本，或直接用 curl。下面是官方文档里的「工单分派部门」示例（choice 类型），可原样复制： curl https://api.openai.com/v1/decisions -H "Authorization: Bearer $OPENAI_API_KEY" -H "Content-Type: application/json" -d '{"model": "gpt-6-luna", "input": "I was charged twice for my order.", "questions": [{"type": "choice", "name": "department", "instructions": "Which department should handle this complaint?", "choices": [{"value": "billing", "description": "Payments, invoices, and refunds."}, {"value": "technical", "description": "Problems using the product."}, {"value": "shipping", "description": "Delivery and tracking."}, {"value": "other", "description": "Requests outside these categories."}]}]}' 返回的 answers 里会有 name 为 department 的答案，含选中的 choice 和置信度 confidence。也可以先在 Playground 里调试问题。来源：developers.openai.com/api/docs/guides/decisions、developers.openai.com/api/docs/changelog（2026-10-06 条目）、OpenAI 开发者社区公告（2026-10-07 核对）。
- predicate（判断题）返回某个条件为真的概率（0–1），如图片里商品有没有明显损坏
- choice（选择题）从你给的固定选项里选一个，并给出置信度，如把工单分到哪个部门
- score（评分题）按你定义的有序等级打分，返回按概率加权的分数，如问题严重程度
- 同一次请求可以对同一份输入提多个不同类型的问题，每个问题按 name 返回答案
- 支持纯文本或「文字 + 图片」的用户消息作为输入
- 目前只支持 gpt-6-luna 模型，官方称比通过 Responses API 调用快约 10 倍
- 支持零数据保留（ZDR）和 HIPAA（需符合条件），数据驻留支持美国和欧洲
- 可通过 Live API 的客户端委托接入语音场景
