TypeSafe Jev 结构化判断

Jev 是 TypeSafe 的 System One 模型。它不生成文本：你传入一段内容（state）和若干类型化问题，它直接返回代码可以用的答案、概率分布和置信度。适合工单分类、内容审核、意图路由、按标准打分这类"判断题"。

项目	说明
模型	jev-1.13.0（固定版本）、jev-latest（最新正式版）、jev-preview（最新预览版）
价格	输入 ¥0.35 / 每 100 万 Token，输出免费
上下文	单次请求 64k Token；state 加最长的那个问题不超过 32k
输入	仅文本：字符串、JSON 对象或文本数组
语言	英文效果最好；中文可用，上线前请用自己的数据测试

请求地址

Jev 用的是 TypeSafe 自己的接口格式，不是 OpenAI 对话接口，地址也不同：

POST https://api-cn.heang.top/typesafe/v1/systemone

海外网络用 https://api.heang.top/typesafe/v1/systemone。认证方式和其他模型一样，用你的星钥 API Key。

三种问题

类型	问什么	返回
choice	从几个选项里选一个	choice、各选项概率、confidence
score	按 2～10 级的标准打分	score、各级概率、confidence
noul	这句话对不对	noul（0～1 之间的值）

一次请求可以混合多个问题，它们针对同一个 state 并行判断、互不影响，多加几个问题几乎不增加耗时。

示例

curl https://api-cn.heang.top/typesafe/v1/systemone \
  -H "Authorization: Bearer $STARKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-latest",
    "state": "Hi, I have been trying to connect my Stripe account for 3 days and the integration keeps failing. I am losing sales. Please help ASAP.",
    "questions": {
      "department": {
        "type": "choice",
        "instructions": "Which team should handle this",
        "criteria": {
          "billing": "Payment or subscription issues",
          "technical": "Bugs or integration problems",
          "sales": "Pricing or account questions"
        }
      },
      "frustration": {
        "type": "score",
        "instructions": "How frustrated the customer appears",
        "criteria": ["Calm, just stating facts", "Frustrated but civil", "Very angry, strong language"]
      },
      "is_urgent": {
        "type": "noul",
        "instructions": "The message conveys urgency or time-sensitivity"
      }
    }
  }'

返回（节选）：

{
  "model": "jev-1.13.0",
  "answers": {
    "department": { "type": "choice", "choice": "technical", "confidence": 0.78, "probabilities": { "technical": 0.85, "sales": 0.0, "billing": 0.15 } },
    "frustration": { "type": "score", "score": 1.0, "confidence": 1.0 },
    "is_urgent": { "type": "noul", "noul": 1.0 }
  },
  "usage": { "input_tokens": 392, "output_tokens": 65 }
}

model 字段告诉你实际是哪个版本作答的，方便记日志。

计费说明

• 只按 usage.input_tokens 计费，输出 Token 免费。上例 392 个输入 Token 约 ¥0.00014。
• 请求开始时会先按 64k 上下文预留额度（约 ¥0.023），完成后按实际输入 Token 结算，多出的部分自动退回。账户余额需要够这笔预留。
• 不支持流式输出，stream 必须省略或为 false。

用好 Jev 的几个习惯

• 一个问题只问一件事。 想"评估这份创业计划"，就拆成市场规模、技术可行性、差异化三个问题，分别打分后在代码里加权。
• 用置信度分流。 confidence 低的结果交给人工或大模型复核，高的直接自动处理。
• 生产环境固定版本。 jev-latest 会随新版本移动，阈值调好后请改用 jev-1.13.0。

更多问题设计方法见 TypeSafe 官方文档。