System One API（Noul / Choice / Score）

调用 System One API 需要三样东西：要用的模型、一段状态（要判断的文字或结构化数据）、以及一组有名字的问题。响应按问题名返回答案，并附带 token 用量。响应里没有任何自由文本。

TypeSafe 的文档定义了三种问题类型。noul 是是非题，答案是一个概率；choice 给出一组选项，每个选项带一句描述，答案是选中的选项和它的概率，TypeSafe 表示最多支持 255 个选项；score 给出一个有序的等级列表，逐级描述，答案是把输入放在这个刻度上的位置。

因为每个允许的答案都由调用方预先声明，所以响应不可能出现声明范围之外的值。这保证的是答案的形状，而不是答案一定正确。

怎么运作

请求是向 TypeSafe 的 System One 端点发 POST，API 密钥以 bearer token 的形式带上。一次请求里的所有问题会针对同一份状态并行求值，所以往一次调用里多加几个问题，不会像串行调用 LLM 那样成倍增加延迟。TypeSafe 提供 Python 和 JavaScript SDK，文档里还列出了一个 Claude Code 插件。API 目前处于早期访问，字段名和限额都可能变化，请以 TypeSafe 当前的文档为准。

举个例子

下面是一个示意性的请求结构（并非照抄 TypeSafe 文档），用三种问题类型给一条客服消息分诊：

{
  "model": "jev-latest",
  "state": "这个月我被重复扣款了，今天就要处理。",
  "questions": {
    "wants_refund": {"type": "noul", "instructions": "客户是否要求退款？"},
    "team": {"type": "choice", "instructions": "应该由哪个团队处理？",
             "criteria": {"billing": "扣款与退款", "support": "故障与使用问题"}},
    "urgency": {"type": "score", "instructions": "紧急程度如何？",
                "criteria": ["可以等", "今天回复", "已经阻塞"]}
  }
}

常见误解

常见问题