登录Console

每个 UTC 日免费调用 5 次

Jev API一个 HTTP 请求调用 Jev 模型

使用 JevModel API 密钥，向 POST https://jevmodel.app/api/v1/systemone 发送一份 state 和最多 8 个类型化问题，即可从真实的 typesafe/jev-1.13 模型拿到可供代码校验的 Choice、Score、Noul JSON 答案。

获取 Jev API 密钥 先在 Playground 试一下

Jev API 快速上手

  1. 01

    创建密钥

    注册、验证邮箱后在 Console 创建 API 密钥。密钥只放在服务端，不要写进浏览器代码。

  2. 02

    发送请求

    POST 一个 JSON：state 可以是文本、JSON 对象或 JSON 数组，再加 1 到 8 个具名问题。不要发送 model 字段，模型是固定的。

  3. 03

    读取答案

    答案按问题 ID 返回。Choice 返回标签和概率，Score 返回数值，Noul 返回 0 到 1 的概率。

请求
curl -X POST https://jevmodel.app/api/v1/systemone \
  -H "Authorization: Bearer $JEVMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state":"The customer was charged twice and wants a refund.","questions":{"queue":{"type":"choice","instructions":"Which team should handle this message?","criteria":{"billing":"Payments, refunds or invoices.","technical":"Bugs, errors or outages.","sales":"Plans, quotes or upgrades."}}}}'
响应（示意数值）
{
  "code": 0,
  "message": "ok",
  "data": {
    "request_id": "example-id",
    "answers": {
      "queue": {
        "type": "choice",
        "choice": "billing",
        "probabilities": {
          "billing": 0.93,
          "technical": 0.04,
          "sales": 0.03
        }
      }
    },
    "usage": {
      "inputTokens": 142
    }
  }
}

Jev API 价格

验证邮箱后，每个 UTC 日前 5 次成功运行免费（受全站容量限制）。之后每次成功请求按模型报告的输入 Token 计费，输出免费，失败请求自动退回。Token 包永不过期，Playground、Batch 和 API 共用一个余额。

查看套餐与 Token 包 →

限制与错误

  • ✓state 与完整请求各不超过 8,000 字符。
  • ✓每次请求 1 到 8 个问题；Choice 支持 2 到 12 个选项，Score 支持 2 到 10 个有序等级。
  • ✓错误返回 {"code":-1,"message":"错误名称"}，HTTP 状态为 400、401、403、413、429、502 或 503。
  • ✓已保存的决策 Flow 通过 POST /api/v1/flows/{id}/run 运行，需要付费 Token 余额。
完整请求与响应说明 →

用 JevModel API 还是 TypeSafe 官方 API？

TypeSafe AI 在 api.typesafe.ai 提供官方 Jev API，并发布了 Python 与 JavaScript SDK。JevModel API 是同一模型的独立 HTTP 接口，经 OpenRouter 调用。

TypeSafe APIJevModel API
端点POST api.typesafe.ai/v1/systemonePOST jevmodel.app/api/v1/systemone
密钥TypeSafe Console 密钥在 JevModel Console 创建的密钥
SDKtypesafe-sdk（Python）、@typesafe-ai/sdk（JS）普通 HTTP；GitHub 上有 curl、Node.js、Python 示例
免费额度以 TypeSafe 价格页为准每个 UTC 日 5 次免费成功运行
附加能力官方支持与 SDK 更新与 Playground、Batch、已保存决策 Flow 共用余额

想要官方 SDK 和直接计费，选 TypeSafe API；想要每日免费次数、免代码 Playground 和 Batch 共用一个余额，选 JevModel。把请求封装在一个适配层里，以后切换也容易。

Jev API 常见问题

有免费的 Jev API 吗？

有。验证邮箱后，JevModel API 每个 UTC 日含 5 次免费成功运行，与 Playground 共用；超出部分使用 Token 余额。

Jev API 怎么收费？

免费次数之外的成功请求，按模型报告的输入 Token 从余额扣除，输出 Token 免费。当前套餐和 Token 包价格见定价页。

有 Jev SDK 或 GitHub 示例吗？

JevModel 没有自己的 SDK，任何 HTTP 客户端都能用。GitHub 上的 jevmodel-examples 仓库提供 curl、Node.js 和 Python 客户端。TypeSafe 为自家 API 发布了官方 SDK。

JevModel API 和 TypeSafe AI 有关系吗？

没有。JevModel 是独立服务，经 OpenRouter 调用 typesafe/jev-1.13。JevModel 密钥不能用于 api.typesafe.ai，TypeSafe 密钥也不能用于本站。

可以发送图片或文件吗？

不可以。API 只接受文本或 JSON；图片请先转成说明文字或 OCR 文本。