决策模型(TypeSafe System One)接口
决策模型面向需要从应用状态和一组问题中得到结构化判断的场景。图灵平台通过 TypeSafe System One 原生协议提供决策模型:请求使用 state 与 questions,响应按问题 ID 返回 answers,不转换为 Chat Completions 的 messages / choices 格式。TypeSafe 的 Jev 与阿里云百炼的决策模型使用同一协议,平台按 model 把请求路由到对应厂商。
本页说明接入方式和模型版本约束。请求、响应字段和交互式 Try-It 见 API 参考 → Call a decision model with TypeSafe System One。
接口概览
| 项目 | 说明 |
|---|---|
| 端点 | POST /api/v1/typesafe/v1/systemone |
| 协议 | TypeSafe 原生 System One |
| 模型 | jev-1.13.0、decision-model-preview |
| 鉴权 | Authorization: Bearer $TURING_API_KEY |
| 响应 | JSON;当前接口不提供流式响应 |
可用模型
model | 厂商 | 版本 | 计费 |
|---|---|---|---|
jev-1.13.0,或 typesafe/jev-1.13.0 | TypeSafe | 固定版本;jev-latest、jev-preview 和其他版本号会被拒绝 | 按输入 token 计费 |
decision-model-preview | 阿里云百炼 | 预览版。百炼只提供这一个模型 ID,没有固定版本号,模型可能随百炼更新 | 限时免费;按输入 token 计费 |
两个模型各自计入独立的用量与速率限制。价格见决策模型列表。
发起请求
state 和 questions 的内容遵循 TypeSafe 的原生定义,图灵平台代理会原样保留未知字段。questions 是以问题 ID 为键的对象;下例询问客户维修请求是否紧急:
curl "https://live-turing.cn.llm.tcljd.com/api/v1/typesafe/v1/systemone" \
-H "Authorization: Bearer $TURING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"state": "A customer asks for an urgent repair",
"model": "jev-1.13.0",
"questions": {
"is_urgent": {
"type": "noul",
"instructions": "Is the request urgent?"
}
}
}'
改用百炼的决策模型时,只需把 model 换成 decision-model-preview,请求的其余部分不变。上表之外的 model 会返回 400。问题定义的类型和字段由 TypeSafe 协议决定,请按 TypeSafe 使用的定义构造 questions。
响应保留 TypeSafe 结构:answers 里的答案与请求的问题 ID 对应,model 是实际服务请求的模型。
{
"model": "jev-1.13.0",
"answers": {
"is_urgent": {
"type": "noul",
"noul": 0.9
}
},
"usage": {
"input_tokens": 12,
"output_tokens": 0
}
}
score类型的答案是等级索引的概率加权期望,可以落在两级之间(如2.25),不一定是整数。- 决策模型不生成文本,按输入 token 计费。百炼只返回
usage.input_tokens,平台补齐usage.output_tokens为0。 - 百炼的响应还带有
request_id和latency_ms,平台原样保留。
错误处理
平台会返回统一错误信封。常见状态码包括 400(请求无效或 model 不受支持)、401(API Key 缺失或无效)、403(无访问权限)、404(上游资源不存在)、429(触发速率限制)和 502(上游返回无效响应或非预期模型版本)。错误响应中的 trace_id 可用于请求追踪。