Decisions API 正式 GA：比 Responses API 快约 10 倍的低成本判定接口解读

Decisions API 是 OpenAI 给「要一个答案，不要一段生成」的场景准备的接口：对文本、图片或 JSON 证据提出结构化问题，拿回带概率的类型化答案。2026-10-22 官方公告宣布它正式 GA，官方指南同步给出了完整的请求形态、三问型语义与定价。本文把 GA 时点的全部关键事实按来源拆开——公告口径、指南参数、SDK 时间线与同日破坏性变更，逐条可复现。

1. GA 时点的官方口径

公告以官方新闻 RSS 2026-10-22 19:00 GMT 条目 "Build more responsive apps with the Decisions API" 出现，描述只有一句：Fast, focused, low-cost decisions for any application（文章页当日对本站 403，本站事实取自 RSS 抓取）。实质内容在官方指南里，指南开头两句是定调的：

• The Decisions API evaluates text, images, and JSON and returns typed answers about 10x faster than the Responses API.——官方给出的是「约 10 倍快」的相对比较，未附延迟绝对值或基准方法。
• Send requests to POST /v1/decisions using gpt-6-luna, the only currently supported model.——端点与模型绑定写死：当前只支持 gpt-6-luna。

官方还开了个 Playground（platform.openai.com/decisions），先试问题再写代码。

2. 请求与答案的形态

请求三件套，指南原表格照录：

响应是 answers 数组，每个问题用唯一 name 标识、API 原样回显。三问型的语义：

choice 与 score 都返回离散选项上的概率分布，另带独立 confidence 字段。答案对象还有 refusal 类型——官方示例代码里有专门分支（answer.type === "refusal"）。官方给的选型边界也很干脆：要按自己的 JSON schema 生成对象用 Structured Outputs，要模型发起工具调用用 function calling，要类型化答案用 Decisions。

3. 一个完整的请求（指南原例）

下面是官方指南里评估支持工单的 JSON 请求体（input_json 块把结构化证据直接塞进 user 消息，免了先序列化成字符串）：

{
  "model": "gpt-6-luna",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Evaluate the ticket using the order evidence."
        },
        {
          "type": "input_json",
          "data": {
            "ticket": { "body": "Please refund the duplicate charge." },
            "order": { "charges": [49, 49] }
          }
        }
      ]
    }
  ],
  "questions": [
    {
      "type": "predicate",
      "name": "duplicate_charge",
      "instructions": "Does the ticket describe a duplicate charge supported by the order?"
    }
  ]
}

SDK 侧的等价调用（官方示例，查商品照片破损）：

import base64
from openai import OpenAI

client = OpenAI()

decision = client.decisions.create(
    model="gpt-6-luna",
    input=[
        {
            "role": "user",
            "content": [
                {"type": "input_text", "text": "Inspect the product in this photo."},
                {"type": "input_image", "image_url": f"data:image/png;base64,{image_base64}"},
            ],
        }
    ],
    questions=[
        {
            "type": "predicate",
            "name": "visible_damage",
            "instructions": "Does the product have visible damage, such as a crack, tear, or dent? Ignore shadows and damage to the packaging.",
        }
    ],
)

answer = decision.answers[0]
if answer.type == "refusal":
    print(f"Refused: {answer.name}")
elif answer.type == "predicate":
    print(f"Visible damage probability: {answer.probability}")

（示例中 image_base64 指向官方原例里的本地图片 base64 编码行与 Path 导入，此处压缩为变量引用；其余逐字照录。）

4. GA 相对 beta 新增了什么

指南 what's new 一节列了 GA 前的九项新增，逐条照录：prompt caching；问题级图片指令（每道题自带对比图片）；input_json 结构化输入；单请求问数上限 200 → 400；托管图片输入（公网 HTTP/HTTPS 图片 URL + base64 data URL 双支持）；会话历史（消息 + 函数/自定义工具调用及输出，call_id 配对）；组织用量上报（token 用量与请求数）；GPT-Live 原生集成（Live 直接调 Decisions，或按输入/输出转写触发）；Private Link 私有连接。

会话历史的输入面有明确边界（指南表格）：user 消息可带文本、图片、JSON；developer/system 消息仅输入文本（system 按 developer 处理）；assistant 消息可带输出文本或拒答；函数/自定义工具输出可带文本与图片。文件、音频与 item 引用不支持。

5. 定价与合规边界

指南 Pricing and availability 节是本篇唯一的一手定价来源，数字逐条照录：

• gpt-6-luna 未缓存输入 $0.10 / 1M tokens；缓存读享折扣价、缓存写收费，读写费率与标准 gpt-6-luna 缓存价一致；
• 输出 token 不计费（Output tokens are not charged）；
• 区域处理溢价与长上下文输入乘数照常适用；
• 该费率仅适用 /v1/decisions——同一模型走其他接口按标准模型与处理档定价（gpt-6-luna 的标准价不在本指南内，本站截至 2026-10-23 未在可加载渠道核实到）；
• 合规面：ZDR 与 HIPAA 支持限合资格客户；数据驻留覆盖全部受支持 API 区域；区域处理限美国与欧洲（EEA + 瑞士）。

6. 缓存的精确规则

Decisions 的缓存语义照录指南：默认在共享 input 末尾放隐式断点，老请求不改请求体就能受益；可复用前缀至少 1,024 tokens（问题内容不计入）；questions 里的内容（含问题级图片）不在可复用前缀内。控制面三件：prompt_cache_key 按调用方分区；共享 input 的文本/图片块可加 prompt_cache_breakpoint: {"mode": "explicit"} 标显式边界；prompt_cache_options.mode 设 "explicit" 后只用标记边界、无标记则不用缓存。问题指令（instructions）里不支持断点。观测走 usage.input_tokens_details.cached_tokens 与 cache_write_tokens——两者都已含在 usage.input_tokens 里，不要再加一遍。

7. SDK 时间线与 GA 当天的破坏性变更

• 2026-10-06（beta 首落）：openai-python v3.26.0（#4033）与 openai-node v7.30.0（#2886）各自合入 add standalone Decisions support——两包 release notes 原文同名。
• 2026-10-16（缓存与 Live）：v3.32.0 / v7.35.0 给 Decisions 加 prompt caching，并把 Decisions 接进 Live 会话触发（本站已有专文，见下方「下一步」）。
• 2026-10-22（GA 当日）：python v3.37.0（#4158，published_at 2026-10-22T20:03:54Z）与 node v7.43.0（published_at 2026-10-22T21:31:14Z）同步破坏性变更——Live 响应里 question 的 instructions 变成 string | 结构化 parts 数组（text/image/JSON），对它直接调字符串方法会炸（node 发布说明的原话例子：question.instructions.trim()）；请求侧输入类型新增消息角色与工具历史项，穷举 switch 要补分支；node 侧 DecisionInputMessage 变联合类型，扩展旧接口要改用 DecisionInputMessage.DecisionInputUserMessage。官方明写：旧字符串 instructions 与 user 消息输入继续支持。

8. 下一步

• Live 会话里触发 Decisions 的机制（triggers、问题三型、delegation），见《openai-python 3.32.0 与 openai-node 7.35.0 更新解读：prompt 建声、Live 音频夹具与 Live Decisions》。
• gpt-6-luna 在 GPT-6 家族里的官方定位（低成本高吞吐档），见《GPT-6 家族扩容:gpt-6-sol、gpt-6-luna、gpt-6.1-sol 进驻官方 SDK,dots 与 Intelligent UI 同窗亮相》。
• 模型选型的整体框架，见《GPT 模型完全指南（2026-07）：GPT-5.6 Sol / Terra / Luna 选型》。