文档 · 模型

Jev（TypeSafe System One）

2026-09-18

Jev 返回什么、怎么调 POST /v1/systemone、TypeSafe 官方线路密钥下方那条一键接入命令、价格多少。

Jev 是 TypeSafe 的 System One 模型。它不生成文字：你发一个 state 和一组带类型的问题，它返回带类型的答案和概率。目录里的模型 id 是 jev-1.13.0，jev-latest 和 jev-preview 是它的别名，转发时原样保留，计费按 jev-1.13.0 算。TypeSafe 发新版本时别名会跟着走，调好阈值以后请固定用 jev-1.13.0。响应里的 model 字段会写明是哪个模型作答。

三种问题类型

noul：是非题。答案是「是」的概率，接近 1 表示是，接近 0 表示否，0.5 附近表示拿不准。没有单独的 confidence。
choice：从你定义的选项表里选一个，最多 255 个选项。答案带 choice、confidence，以及每个选项的 probabilities。
score：在你用文字描述的 2 到 10 级量表上定位。答案按概率加权，可以落在两级之间，字段有 score、confidence、legend、probabilities。

同一个请求里的问题彼此独立、并行评估，所以把可能用到的问题都放进一次调用。问题的 id 不会发给模型，完整的问题要写在 instructions 里。

请求与响应

curl -X POST https://ai.topxea.com/v1/systemone \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "I have asked three times now. Can I please just talk to a real person?",
    "model": "jev-latest",
    "questions": {
      "is_human_escalation": {
        "type": "noul",
        "instructions": "Is the customer asking for a human agent?"
      }
    }
  }'

{
  "model": "jev-latest",
  "answers": {
    "is_human_escalation": { "type": "noul", "noul": 0.99 }
  }
}

响应里还会带 usage，含 input_tokens 和 output_tokens。请求体和 TypeSafe 官方 API 完全一样，只有 base URL 和密钥换成 TopxAI 的。POST /v1/system_one 是同一个端点的另一种写法，转到同一个上游。在这个端点上请求 Jev 以外的模型，会收到 400。

预留额度之前，中转服务先检查请求体：不超过 1 MiB，必须有 model、state 和非空的 questions 对象，不满足就返回 400。TypeSafe 用 422 拒绝请求时，你会原样收到它的校验信息，预留的额度随即释放。429 会连同 Retry-After 一起转给你，退避后重试。上游故障或上游密钥失效，统一返回 503。

一条命令接入

在 API 密钥 页面上创建密钥。在分组里找到 TypeSafe 区块，选 官方线路（旁注「官方密钥 · 牌价的 107%」）。自动路由 密钥也能调 Jev（Jev 只有一条线路），但下面这条接入命令只在 TypeSafe 线路的密钥上显示。在密钥所在行点开完整密钥的弹层，或者打开密钥详情抽屉，都能看到 Jev 一键接入：

curl -fsSL https://ai.topxea.com/install/typesafe.sh | sh -s -- --key sk-xxxx

脚本会安装 typesafe-ai agent skill，把 TYPESAFE_BASE_URL=https://ai.topxea.com 和 TYPESAFE_API_KEY=<你的密钥> 写进 ~/.config/topxai/typesafe.env，在 ~/.zshrc 和 ~/.bashrc（哪个存在改哪个）里加一段读取这个文件的托管配置，~/.claude/settings.json 存在的话再把这两个变量合并进它的 env。最后发一次测试请求：这是一次真实计费的调用，用 jev-latest 问一道 noul 题；返回 401 说明密钥不对。

不带 --key 时，脚本先取环境变量 TOPXAI_API_KEY，再复用上次运行保存的密钥，都没有才在终端里让你输入，输入过程不回显。一个密钥都没有时，skill 和配置照常安装，只跳过测试请求。--no-skill 和 --no-verify 分别跳过装 skill 和测试请求两步，--base-url 指向别的中转地址，-h 打印帮助。可以重复运行，涉及的文件每次都原地重写，settings.json 会先留一份带时间戳的 .bak 备份。

官方 SDK（pip install typesafe-sdk、npm install @typesafe-ai/sdk）会读 TYPESAFE_BASE_URL 和 TYPESAFE_API_KEY 两个变量，然后自己调用 /v1/systemone；用 TYPESAFE_DEFAULT_MODEL 指定模型。

价格与限制

每 100 万输入 token 收 0.04494 美元，是 TypeSafe 牌价 0.042 美元的 107%。输出 token 免费。费用按供应商返回的 usage.input_tokens 结算；响应里没有 usage 时，按调用前预估并预留的 token 数收。限制：上下文窗口 64K，单次请求上限 64k token，其中 state 加最长的一个问题不超过 32k。

已知短板

以下都来自 TypeSafe 自己的文档：

按字面回答你写下的问题，不猜你想问什么。
不会算术；日期当文本读，不当数值比较。
双重否定、多跳推理、state 里的无关内容都会拉低准确率。
互相矛盾的判据会让答案不可靠。
没有训练过生成文字。
只接受文本输入。英文是主要训练语言，中日韩文本「能处理，但效果不一样好」。
不同问题类型之间的阈值不能互相套用。

有问题可以点网站右下角的帮助按钮，或者写信到 support@topxea.com。

模型：jev-1.13.0 · 模型与价格