Decisions API 推出公开测试版

Decisions API 可评估文本、图像或二者兼有，速度比 Responses API 快 10 倍。它能返回条件为真的概率、固定选项中的选择，或按评分标准打分的结果。利用这些答案，你可以对内容进行分类、路由请求以及在应用中对工作进行优先级排序。

在Playground中试用 Decisions API，在编写代码之前即可实验不同的问题和输入。

Decisions API 目前处于公开 Beta 阶段，预计几周内正式发布。 gpt-6-luna 是当前唯一的可用模型。请使用专用的 POST /v1/decisions 端点。

Decisions 的工作方式

一个请求包含三个部分：

字段	用途
model	评估请求的模型。目前仅支持 gpt-6-luna。
input	供所有问题共享的证据：一个文本字符串，或包含文本和图像的用户消息。
questions	待评估的内容，包括每个问题的类型、指令，以及允许的选项或评分等级。

响应包含一个 answers 数组。为每个问题指定唯一的 name 以标识其答案；API 会在响应中回显该名称。

选择问题类型

类型	用于	主要结果
predicate	检查条件，例如可见损坏或段落相关性。	probability：条件为真的 0 到 1 的概率估计。
choice	选择一个选项，例如部门或内容类别。	choice：您提供的值之一。
score	根据有序等级对输入进行评分，例如问题严重程度。	score：等级索引的概率加权平均值。

两种方法 choice 和 score 都会返回针对离散选项的概率分布。对于无顺序的类别（如部门），使用 choice；对于有序等级（如严重程度），使用 score。它会计算数值的概率加权平均值，生成可能落在两个等级之间的分数。

当你的应用需要上述类型的回答时，请使用 Decisions。如果需要生成符合自定义 JSON schema 的对象（如提取的字段或书面说明），请在 Responses API 中使用 Structured Outputs；如果需要模型请求带有参数的工具调用，则使用 function calling。

检查图像中的可见损伤

使用 predicate 问题来检查产品照片是否存在可见损伤。此请求会将图像与指令结合，让模型查找裂纹、撕裂或凹痕。

凹痕

取消

回答相关性

这件物品有凹痕吗？

概率 1.00

“

请在下次续费前取消我的订阅。

我可以切换到年度计费并保留当前套餐吗？

我不再需要这个服务了。如何停止后续扣款？

概率 1.00问题

30天后还能退货吗？

回答

收货后30天内可接受退货。逾期则无法退款。

在您的账户“订单”页面发起退货。

标准配送需要3到5个工作日。

12345678910111213141516171819202122IMAGE_BASE64="$(base64 < product.png | tr -d '\r\n')"

curl https://api.openai.com/v1/decisions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<JSON
{
  "model": "gpt-6-luna",
  "input": [{
    "role": "user",
    "content": [
      {"type": "input_text", "text": "Inspect the product in this photo."},
      {"type": "input_image", "image_url": "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."
  }]
}
JSON

响应示例如下：

123456789{
  "answers": [
    {
      "type": "predicate",
      "name": "visible_damage",
      "probability": 0.92
    }
  ]
}

probability 是模型对条件为真的置信度估计。你可以根据自定的阈值，用它来筛选出需要人工复核的照片。

图片必须以 base64 数据 URL 的形式内联传入。此端点不支持 HTTP/HTTPS 托管图片链接，也不支持 file_id 输入。可以在 user 消息中同时组合 input_text 和 input_image，以便在评估图片时附带说明文字或其他上下文。

从固定选项中选择

choice 类型的问题会从你提供的选项中选出一个值。选项的值应彼此区分，并配上描述说明各自适用的场景。

驾驶

团队分配

文档类型

汽车应该选择哪条车道？

123Lane 10.03Lane 20.94Lane 30.03

“

这个月我被重复扣款了，能帮我退还多收的部分吗？

CSV 导出一直报错，刷新页面也没用。

我的手机丢了，过不了两步验证。

Billing1.00Technical support0.00Account access0.00NORTHLINE STUDIO № 1042

Invoice

Billed to Cedar & Co.

Design services$1,200.00Amount due$1,200.00

Payment due October 21

NORTHLINE STUDIO № 6853

Payment received

Thank you for your purchase.

Design services$1,200.00Total paid$1,200.00

Visa ending in 4242 · Approved

NORTHLINE STUDIO 01 / 03

Services agreement

Between Northline Studio and Cedar & Co.

供应商承诺在十二个月的期限内提供设计服务。

供应商签名 客户签名 发票 1.00 收据 0.00 合同 0.00

此请求用于将客户投诉路由至相应部门：

123456789101112131415161718curl 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."}
      ]
    }]
  }'

响应示例如下：

12345678910111213141516{
  "answers": [
    {
      "type": "choice",
      "name": "department",
      "choice": "billing",
      "probabilities": [
        { "value": "billing", "probability": 0.95 },
        { "value": "technical", "probability": 0.02 },
        { "value": "shipping", "probability": 0.01 },
        { "value": "other", "probability": 0.02 }
      ],
      "confidence": 0.93
    }
  ]
}

答案中的 choice 字段包含一个预设值，本例中为 "billing"。此外还包含一个各选项的 probabilities 数组以及 confidence 字段。请参阅解读答案以获取设置阈值的指导。

当现有分类无法涵盖所有可能的输入时，请包含一个类似 "other" 的兜底选项。应用程序可以将此类结果发送至通用审核队列。

基于评分标准进行打分

score 类型的选项会针对有序的 levels 对输入进行评估。您需要定义每个等级的标准，并按从低到高的顺序排列。

包裹

紧急请求

这个包裹损坏程度如何？

0.00/ 20 · 无损坏1 · 轻微损坏2 · 严重损坏无损坏1.00轻微损坏0.00严重损坏0.00

“

能否增加暗色模式？夜间工作时会更有帮助。

CSV 导出功能对其中一位团队成员持续失败。团队其他人仍可正常导出。

结账功能对所有客户均失败。过去 20 分钟内未处理任何订单。

0.00/ 20 · 低1 · 中2 · 高低1.00中0.00高0.00

1234567891011121314151617curl https://api.openai.com/v1/decisions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-luna",
    "input": "导出在 Safari 中失败但在 Chrome 中正常。",
    "questions": [{
      "type": "score",
      "name": "severity",
      "instructions": "此问题的严重程度如何？",
      "levels": [
        {"label": "Cosmetic", "description": "仅外观问题，无功能丧失。"},
        {"label": "Workaround available", "description": "任务失败，但存在替代方案。"},
        {"label": "Fully blocked", "description": "任务失败且无替代方案。"}
      ]
    }]
  }'

一个示例响应摘录：

123456789101112131415{
  "answers": [
    {
      "type": "score",
      "name": "severity",
      "score": 1.1,
      "probabilities": [
        { "value": 0, "label": "Cosmetic", "probability": 0.1 },
        { "value": 1, "label": "Workaround available", "probability": 0.7 },
        { "value": 2, "label": "Fully blocked", "probability": 0.2 }
      ],
      "confidence": 0.55
    }
  ]
}

等级索引从 0 开始。在此例中，0 表示轻微（Cosmetic），1 表示有替代方案（Workaround available），2 表示完全阻塞（Fully blocked）。返回的 score 是概率加权平均值，因此可能落在等级之间。在这个例子中，概率 0.1、0.7 和 0.2 产生得分 1.1。

答案还包含 confidence 和各等级的 probabilities。得分总结了各等级上的分布。使用 choice 可选择单一类别。

提出多个问题

把相互独立的问题放进同一个 questions 数组，共享同一次输入评估。比如处理一张产品照片，可以在一次请求中同时检测破损并分类产品类目。每个问题可以使用不同的题型。

如果某个决策依赖前一个答案，则应分开请求。例如先检测是否破损，再根据结果决定是否需要请求维修类目。

问题应围绕可观察的标准来写。把不同的关注点拆成不同的问题，让各选项含义清晰不重叠，并为分数定义明确的等级标准，确保相邻等级之间界限分明。

解读返回结果

判定类问题返回条件成立的估计概率；选择和评分类问题返回一个概率分布，以及一个单独的 confidence 字段。

用来自你应用的真实标注样本为路由、过滤或人工审核设置阈值，并根据假阳性和假阴性的成本来选择合适的阈值。

价格与可用性

使用 gpt-6-luna 时，输入价格为 每 100 万 token $0.10。你只需为输入 token 付费，没有缓存读取、缓存写入或输出 token 的费用。

区域处理溢价和长上下文输入价格倍率另行适用。以上价格适用于 /v1/decisions；其他使用 gpt-6-luna 的请求按适用的模型与处理层级定价收费。

Decisions API 为符合条件的客户提供零数据留存（ZDR）和 HIPAA 合规支持。美国和欧洲（EEA + 瑞士）支持数据驻留和区域处理。资格要求、所需协议及限制请参阅数据控制文档。

添加语音控制

通过Live API 的客户端委托，可以从语音请求中挑选要执行的操作，并把执行结果反馈给用户。