开发者 / JevModel

JevModel API:请求与响应

使用 JevModel API 密钥,通过 /api/v1/systemone 发送类型化判断问题。

最近更新:

直接回答

  • 本指南说明 JevModel 的 /api/v1/systemone 契约,包括本站鉴权、限制与额度结算,不代表所有 Jev 风格提供方的接口。
  • OpenAI Decisions 使用具名问题数组;Cloudflare Clef 使用自己的端点与包装格式。迁移前在提供方适配器中验证答案、缺失字段、错误与复核出口。

发送第一个请求

验证邮箱后,在账户设置中创建 JevModel API 密钥。密钥只放在服务端,向本站 /api/v1/systemone 发送 POST 请求。以下示例提出一个是/否问题。本站通过 OpenRouter 固定调用 typesafe/jev-1.13,无需发送 model 字段。

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 requests a refund.","questions":{"escalate":{"type":"noul","instructions":"Should a human billing specialist review this request now?","criteria":{"true":"A specialist should review it now.","false":"No immediate review is needed."}}}}'

请求字段与限制

发送文本、JSON 对象或非空 JSON 数组作为 state,并定义 1–8 个具名问题。序列化后的 state 和校验后的完整请求均不能超过 8,000 字符。问题 ID 须以小写字母开头,总长不超过 40,只能包含小写字母、数字和下划线。instructions 长 8–600 字符;Choice 需要 2–12 个具名选项,Score 需要 2–10 个有序等级,Noul 的 true 和 false 描述都必填。每条描述长 2–350 字符。

读取响应

成功响应使用下方的 JevModel 包装格式。data 包含 request_id、按问题 ID 索引的 answers、上游 usage 和剩余额度。示例数值仅用于说明。Choice 可返回标签与概率分布;Score 为可能带小数的数值;Noul 是 0 到 1 之间的“是”的概率。实际动作阈值应由你的应用决定。

{
  "code": 0,
  "message": "ok",
  "data": {
    "request_id": "example-id",
    "answers": {
      "escalate": {
        "type": "noul",
        "noul": 0.94
      }
    },
    "usage": {
      "inputTokens": 186
    },
    "quota": {
      "tokenBalance": 99814,
      "hasPurchased": false,
      "signupGrant": 10000,
      "globalUsed": 1,
      "globalLimit": 1000,
      "dayUtc": "2026-09-28"
    }
  }
}

错误、重试与计费

错误响应形如 {"code":-1,"message":"错误名称"}。HTTP 400 表示 JSON 或字段无效;401 表示密钥无效;403 表示邮箱未验证;413 表示请求过大;429 表示 Token 余额不足(INSUFFICIENT_TOKENS)或全站容量已满(GLOBAL_DAILY_LIMIT);502 表示上游未返回可用结果;503 表示模型连接不可用。客户端应同时检查 HTTP 状态和 code。验证邮箱的账户先获赠 10,000 免费 Token;每次成功运行按模型报告的输入 Token 从工作台与 API 共用余额扣除,并受全站容量限制。失败运行会退回预扣额度。本站 API 尚不支持幂等请求头:若成功运行后响应丢失,请先检查账户历史和余额,再决定是否重试,避免重复扣费。

运行 GitHub 示例

下方 JevModel 示例仓库提供 curl、Node.js 和 Python 客户端,包含客服分类、线索评分和人工复核。在克隆后的仓库根目录运行命令。离线演示无需依赖或密钥,输出为示意数据,不是真实模型记录。设置 JEVMODEL_API_KEY 并加 --live 才发起一次真实请求,可能消耗额度或 Token。示例不自动重试,也不执行外部业务动作。这是独立 JevModel 示例,不是 TypeSafe 官方 SDK。

如何用 JevModel API 分类文本Jev API 批量文本分类:CSV 与 JSONLJev AI 决策流与人工复核分支JevModel 价格与 Jev 免费额度
git clone https://github.com/SouthCat196/jevmodel-examples.git
cd jevmodel-examples
node quickstart/node.mjs
# Or: python quickstart/python.py
# Bash / Git Bash: bash quickstart/curl.sh

JevModel 为独立项目,与 TypeSafe AI 无关联。