理解 OpenAI Decisions API：它与 Jev 有什么不同，如何上手

OpenAI Decisions API 是一个用于有限选项决策的限量预览 API。开发者提供上下文，定义问题和候选答案，模型直接返回决策，供程序继续处理。

很多软件流程并不需要模型再写一段解释。客服系统需要一个负责团队，Agent 需要下一步工具，工作流需要一个风险等级。决策接口的目标，就是直接给出这些程序要使用的结果。

OpenAI 现在把这类能力作为一种独立 API 发布。TypeSafe 的 Jev 则已经有公开 API，也属于面向软件决策的模型。本文先介绍 OpenAI 已确认的信息，再和 Jev 对比，最后一步一步演示如何在 decisions-api.org 上试用 Jev。

一、OpenAI Decisions API 是什么

OpenAI 在 2026 年 9 月 29 日的 DevDay 上介绍了 Decisions API：开发者传入上下文（文本或图片），定义问题和有限的可能答案，API 返回答案。OpenAI 举出的用途包括内容分类、请求路由，以及选择 Agent 下一步动作。该 API 目前处于限量预览阶段，OpenAI 表示计划在接下来的几天扩大开放范围。OpenAI DevDay 发布回顾

可以把它理解为程序调用模型的边界发生了变化：

聊天模型的流程
上下文 → 提示词 → 自然语言解释 → 解析和校验 → 程序分支

决策模型的流程
上下文 → 问题 + 候选答案 → 类型化决策 → 程序分支

当应用本来就知道允许采取哪些下一步时，第二种输出形态更直接。它可以减少连接文本与业务代码的胶水逻辑，但仍然需要认真设计标签、检查边界案例，并让高风险操作留在应用代码中控制。

OpenAI 的发布说明称 Decisions API 使用 Luna 的智能，并接受文本和图片上下文。一篇 DevDay 现场报道提到它是一个专用的 GPT-6 Luna 版本，演示响应约 150 毫秒；同一报道把它与普通 Luna 调用约 1.6 秒的响应作比较。这里的数字来自发布演示报道，不是基准测试、生产保证或服务等级协议。Pasquale Pillitteri 的 DevDay 报道

截至 2026 年 9 月 30 日，我没有在 OpenAI 开发者文档里找到公开的 Decisions API Reference、请求结构、正式端点或独立定价。查看 API 更新日志 也没有找到 Decisions API 条目。因此，网上出现的 POST /v1/decisions 等路径，不应当被当作官方接口契约直接使用。功能发布是真的，但公开实现细节仍待文档公布。

二、Jev 与 OpenAI Decisions API 的区别

TypeSafe 的 Jev 是 System One 系列的第一个模型。它的公开 API 接收一份 State 和若干类型化问题。主要问题类型有：从命名选项中选择的 Choice、有序等级评分的 Score，以及判断真假命题的 Noul。Jev 返回结构化答案和概率信号；TypeSafe 的直接调用端点是 POST https://api.typesafe.ai/v1/systemone。TypeSafe API 介绍 · API 参考

对比项目	OpenAI Decisions API	TypeSafe Jev
可用状态	2026 年 9 月 29 日宣布限量预览	已提供公开 API 和 API 文档
官方介绍的输入	文本或图片上下文	主要是文本 State，也可组织为结构化文本 / JSON
决策形式	问题加有限候选答案	Choice、Score、Noul 类型化问题
概率	发布报道提到概率；公开技术细节尚未公布	文档中的答案结构包含概率字段
校准	目前查看的公开 API 文档没有技术说明	TypeSafe 称使用 RLCD 训练校准决策；这是服务方说明，不保证每个答案都准确
延迟	一篇现场报道的演示约 150 毫秒；不是 SLA	TypeSafe 将 Jev 定位为低延迟决策模型；应使用自己的流量测量
定价和结构	截至 2026 年 9 月 30 日，没有找到独立公开价格或 API schema	TypeSafe 标示每十亿输入 Token 42 美元（每百万 Token 0.042 美元），并公开 Swagger API

TypeSafe 把自己的方法称为 RLCD（Reinforcement Learning for Calibrated Decisions，校准决策强化学习）。文档说明校准应该在一组预测上观察，而不是保证每个单独概率都正确。真正上线前，要用带标签的样本验证准确率、概率校准和不同错误的代价。TypeSafe 机器学习入门 · TypeSafe 定价

因此，不要只比较演示数字。应该在同一组真实样例上比较最终决策：是否路由正确、是否漏掉升级处理、延迟是多少、花费多少，以及多少案例需要人工接管。阈值和有影响的业务动作仍应由应用代码控制。

三、如何在 decisions-api.org 上试用 Jev

decisions-api.org 是独立的 Playground 和 API 服务。当前工作台可以调用 Jev 等决策模型，但还没有接入 OpenAI 的限量预览 Decisions API。因此，下面的步骤使用网站提供的 Jev 集成以及网站自己的 API 契约，不需要 OpenAI API Key。

第一步：打开一个现成的决策示例

打开 支持请求路由示例，登录账号。新账号会一次性获得 100 个欢迎积分；加载示例不消耗积分，实际运行模型会消耗积分。如果模型选择器没有选中 typesafe/jev-1.13，请手动选择。

截图展示了示例的输入界面。页面中任何静态预览都标有示意说明，不是模型的实际回答。需要分析结果或概率时，要先运行自己的样例。

第二步：把问题写成一个明确的决策

先写一段精简的 State，只包含相关事实，再提出一个具体问题。例如，“这条请求应该交给哪个团队？”比“理解这位客户”更容易评估。随后列出允许的去向，并解释每个选项的含义。在 Jev 中，这类问题对应 Choice。

第一次实验可以只问一个问题，选项设为 billing、technical 和 general support。然后分别测试普通、边界和含糊不清的工单。每次只修改一个条件，方便确认变化来自上下文、问题说明还是候选项。

第三步：运行样例并检查结果

点击 Run 发起真实请求，查看所选选项和概率。需要数值型严重程度时可添加 Score，需要判断一个明确命题时可使用 Noul。概率不是测得的准确率，也不等于授权系统自动执行高风险动作。

如果你有带标签的历史样例，可以把模型决策与标签进行对比，记录错误路由、漏掉的升级、响应延迟和人工复核成本。在评估支持更高自动化程度之前，让不确定或高风险案例进入人工队列。

第四步：创建网站 API Key

进入 API Keys 页面，为应用创建一个密钥。这个 Key 属于 decisions-api.org。将它保存在服务端环境变量中，例如 DECISIONS_API_KEY，不要放进浏览器代码或公开仓库。网站的 API 快速入门 介绍了平台 API。

第五步：在服务端发送一个决策请求

下面是根据网站文档编写的最小请求，使用网站的 API 端点和 Jev 模型。请将示例 State 替换为你的应用获准发送的数据。

curl -X POST https://decisions-api.org/v1/systemone \
  -H "Authorization: Bearer $DECISIONS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: support-ticket-1842" \
  -d '{
    "model": "typesafe/jev-1.13",
    "state": {
      "message": "I paid yesterday but still do not have access.",
      "account_status": "active"
    },
    "questions": {
      "department": {
        "type": "choice",
        "instructions": "Which team should handle this request?",
        "criteria": {
          "billing": "Payment, invoice, refund, or access after payment",
          "technical": "A product bug or service failure",
          "general": "A request that does not fit the other teams"
        }
      }
    }
  }'

网站 API 会包装成功结果，可以从 data.result.answers.department 读取所选答案。每个逻辑请求都应该使用唯一的 Idempotency-Key；如果重复提交相同 Key，网站会阻止重复模型调用。这是 decisions-api.org 的接口形状，不是 TypeSafe 或 OpenAI 的直接接口。网站 API 完整文档

第六步：由应用代码决定如何分支

decisions-api.org 从网站账户积分中扣费。当前工作台标示 Jev 为每百万输入 Token 600 个积分；成功调用按实际输入 Token 结算，每次至少 1 个积分，输出 Token 不收费。10,000 个积分售价 1 美元。该平台账单与 TypeSafe 直接调用的每百万 Token 0.042 美元是两回事。估算项目成本时，请查看工作台最新计费说明以及网站 API 限制和计费说明。

应用应该负责解释答案并选择动作。例如，高置信度、低风险工单可以自动路由；不确定的工单进入支持队列。权限校验、付款变更、关闭账号等后果较大的操作，应该继续使用确定、可审计的规则控制。

应该先评估哪一个

OpenAI 的发布让“决策 API”成为更受关注的接口类型：软件经常需要的是分类、评分、路由或下一步动作，而不是一段文字解释。若图片输入能力按发布说明进入正式 API，它对视觉工作流也会很有吸引力。不过，目前还需要等待正式端点、结构、价格和概率校准细节。

Jev 可以通过 TypeSafe 公开 API 或 decisions-api.org 工作台立即试用。先选一个低风险且答案范围清晰的问题，准备一组带标签的评估样例。模型负责给出判断；你的应用仍然负责决定这次判断是否足够可靠、是否可以执行。

**资料核对日期：**2026 年 9 月 30 日。功能开放状态和价格可能变化。

资料来源：OpenAI DevDay 发布回顾 · OpenAI API 更新日志 · TypeSafe Jev 介绍 · TypeSafe API 文档 · TypeSafe 校准说明 · TypeSafe 定价 · DevDay 响应延迟报道

本文是独立的产品指南。decisions-api.org 不是 OpenAI 产品，Jev 是 TypeSafe 的模型。

---

（完）