Jev API 教程：发送并读懂第一个请求

Jev API 接收 state 和一组有名称的类型化问题，再以相同名称返回答案。本指南用一个紧急程度判断帮助你先读懂单次决策，再接入应用。请求格式依据官方 API 文档编写，本站尚未使用自有密钥执行实时验证。

1. 获取访问并保护密钥

可以打开官方 Playground 体验，也可以登录官方控制台获取 API key。先确认账号具有模型权限，并检查计费条件。把 TYPESAFE_API_KEY 放在 shell 环境变量或服务端密钥管理器中，不要把真实密钥放进公开网页、仓库或浏览器代码。

官方访问入口: Playground · API keys

2. 发送一个小请求

下面的 cURL 示例从环境变量读取密钥，并固定 jev-1.13.0 作为可追溯的模型标识。各语言页面保留同一份英文 state 和问题；其他语言的模型效果要单独评估。使用自己的密钥运行命令会发起真实、可能计费的请求。

curl --fail-with-body --max-time 30 \
  https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{
  "model": "jev-1.13.0",
  "state": "Our payment integration has failed for three days. Please help ASAP.",
  "questions": {
    "urgency": {
      "type": "noul",
      "instructions": "Does this message express urgency?"
    }
  }
}
JSON

3. 读取返回答案

在响应中找到 answers.urgency.noul。Noul 是是非问题中“是”的概率，不是文本标签。model 告诉你实际回答的版本，usage.input_tokens 可用于成本测量。下面的响应片段是说明性示例，不是抓取的 API 实测结果；你的数值可能不同。

说明性的响应片段:

{
  "model": "jev-1.13.0",
  "answers": {
    "urgency": {
      "type": "noul",
      "noul": 0.94
    }
  }
}

4. 决定程序下一步怎么做

使用结果前验证返回类型和数值范围。示意规则可以把概率不低于 0.8 的消息标记到紧急队列，其余进入普通或人工复核流程。这个阈值不是官方安全默认值，应该根据标注样本和误判代价选择。模型输出不能绕过权限检查。

5. 按需加入 Choice 或 Score

部门路由可使用 Choice，明确账单、技术、销售和兜底选项的 criteria。有序评价使用 Score，逐级写清含义。Choice 与 Score 返回概率分布和 confidence；Noul 返回“是”的概率，不要假设它也有同样的 confidence 字段。

6. 处理错误与版本变化

认证失败时检查请求头、密钥和权限；请求不合法时核对 JSON 与官方 schema。遇到 429，若有 retry-after 就遵守，并采用有上限的退避；官方 SDK 已包含重试行为。网络请求设置超时，实际操作保持幂等，缺失或无效答案进入复核。切换固定模型版本前重新评估阈值。

继续阅读

模型概览 · 应用场景 · 价格说明 · 模型限制