Jev API：文本分类、路由与打分

为这次接入创建一个密钥，存进应用服务端的环境变量 JEV_AI_API_KEY，不要把它粘贴到编程助手的对话里。第一次创建？请看分步的 Jev API 密钥指南（英文）。

端点

POST https://jev-ai.pro/api/v1/systemone
Authorization: Bearer <JEV_AI_API_KEY>
Content-Type: application/json

请求

curl https://jev-ai.pro/api/v1/systemone \
  -H "Authorization: Bearer $JEV_AI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "Help! My payouts have been failing for 3 days.",
    "model": "jev-latest",
    "questions": {
      "is_urgent": { "type": "noul", "instructions": "Does this convey urgency?" },
      "department": {
        "type": "choice",
        "instructions": "Which team should handle this?",
        "criteria": { "billing": "Payments and refunds", "technical": "Bugs and outages", "sales": "Pricing" }
      },
      "frustration": {
        "type": "score",
        "instructions": "How frustrated is the customer?",
        "criteria": ["Calm", "Frustrated", "Very angry"]
      }
    }
  }'

返回

{
  "model": "jev-1.13.0",
  "answers": {
    "is_urgent": { "type": "noul", "noul": 0.95 },
    "department": {
      "type": "choice", "choice": "billing", "confidence": 0.98,
      "probabilities": { "billing": 0.99, "technical": 0.01, "sales": 0.0 }
    },
    "frustration": {
      "type": "score", "score": 1.04, "confidence": 0.94,
      "legend": { "0": "Calm", "1": "Frustrated", "2": "Very angry" },
      "probabilities": { "0": 0.0, "1": 0.96, "2": 0.04 }
    }
  },
  "usage": { "input_tokens": 379, "output_tokens": 70 }
}

每个答案都放在你自定义的问题 id 下。choice 和 score 类答案带有 probabilities 和 0 到 1 之间的 confidence；noul 类答案就是“是”的概率。

TypeSafe 官方 SDK

@typesafe-ai/sdk 由 TypeSafe 发布。Jev AI 是提供兼容托管端点的独立服务，这个 SDK 并非 Jev AI 发布。

已经在用 TypeSafe 官方 SDK？Jev AI 密钥和 base URL 都要改。只换密钥的话，请求仍会发到 SDK 默认的 TypeSafe 服务。Jev AI 的密钥和余额与 TypeSafe 相互独立。

JavaScript / TypeScript 中设置 baseURL: 'https://jev-ai.pro/api'。SDK 会自动补上 /v1/systemone，所以 base URL 里不要带 /v1 或完整路径。最终请求地址必须是 https://jev-ai.pro/api/v1/systemone。

// Official TypeSafe SDK, published by TypeSafe — @typesafe-ai/sdk 0.6.0
// Server-side JavaScript / TypeScript using the Jev AI compatible endpoint
import { TypeSafeClient, choice } from '@typesafe-ai/sdk'

const apiKey = process.env.JEV_AI_API_KEY
if (!apiKey) throw new Error('Set JEV_AI_API_KEY on your server')

const client = new TypeSafeClient({
  apiKey,
  baseURL: 'https://jev-ai.pro/api', // Required, including for existing SDK users
  retry: { maxRetries: 0 }, // Avoid replaying a request with an uncertain outcome
})

// The SDK appends /v1/systemone to baseURL.
const response = await client.systemOne({
  model: 'jev-latest',
  state: { document: 'I was charged twice. Please fix this ASAP.' },
  questions: {
    category: choice('What is this ticket about?', { billing: null, technical: null, other: null }),
  },
})
console.log(response.answers.category.choice)

示例关闭了自动重试，避免在结果不确定时重复发送请求。正式发起会扣余额的判断调用前，请先对照 TypeSafe SDK 连接检查清单（英文）。

已用 @typesafe-ai/sdk 0.6.0 测试。GET /api/v1/models 列出可用模型名，GET /api/v1/credits 返回 creditsRemaining 和 paidInputTokensRemaining。旧版积分字段仍保留以兼容老代码。

调用已保存的评判器

编辑器默认使用官方格式：完整的 state、model 和 questions，只需更换端点和密钥，就能在 Jev AI 与 TypeSafe 之间通用。选择已保存评判器 ID则使用下面这种 Jev AI 专属的简写；TypeSafe 无法识别这些 ID。

先创建并管理你的评判器，打开其中一个并选择 API 代码，即可拿到可直接复制的示例。请使用同一账户下的 API 密钥。

POST /api/v1/systemone
{
  "judgeId": "YOUR_SAVED_JUDGE_ID",
  "revision": 1,
  "state": "New text to evaluate"
}

用 judgeId 代替 questions。每次调用都会用保存好的规则评判你传入的新 state；返回格式和 token 计费与普通 API 调用相同。

revision 可选。带上它时，规则一旦变更，调用会返回 HTTP 409；不带则始终使用最新保存的版本。响应头 X-Jev-Judge-Id 和 X-Jev-Judge-Revision 标明本次使用的规则。已删除或无权访问的评判器返回 HTTP 404。

实时网页上下文

Jev 本身不会上网。POST /api/v1/web-context 会针对你的是非问题搜索网页，把搜索结果作为证据放进 Jev 的 state，并同时返回有证据和无证据两种情况下 Jev 的答案。可以先在浏览器里试用。

POST https://jev-ai.pro/api/v1/web-context
Authorization: Bearer <JEV_AI_API_KEY>
Content-Type: application/json

{
  "question": "Has OpenAI released GPT-6?",
  "query": "OpenAI releases GPT-6 announcement",
  "criteria": {
    "yes": "OpenAI has publicly released a model named GPT-6",
    "no": "No model named GPT-6 has been released"
  },
  "num_results": 6,
  "attribution": false
}

{
  "decision": "yes",
  "confidence": 0.88,
  "with_web": { "answer": { "type": "choice", "choice": "yes", "probabilities": { "yes": 0.88, "no": 0.12 }, "confidence": 0.88 }, "usage": { ... } },
  "without_web": { "answer": { "type": "choice", "choice": "no", ... }, "usage": { ... } },
  "sources": [{ "title": "...", "url": "https://...", "publishedDate": "2026-09-10T00:00:00.000Z", "highlights": ["..."] }],
  "source_weights": null,
  "usage": { "input_tokens": 2140, "output_tokens": 12, "jev_calls": 2, "web_search": true },
  "latency": { "search_ms": 560, "jev_ms": 410 }
}

只有 question 是必填项。query 默认等于问题本身，criteria 默认是通用的是非规则。num_results 取 1 到 10（默认 6）。设置 attribution: true 会返回 source_weights：去掉每条来源后，胜出答案的概率下降多少。它会对每条来源各重跑一次 Jev，这部分输入 token 同样计费。

想用自己的证据，可以传 sources（最多 10 个对象，含 title、url、publishedDate 和 highlights）。这样不会触发搜索，也不收搜索费。

计费：所有 Jev 调用的实际输入 token，加上每次网页搜索 170,000 token。token 不足时，每次请求扣 2 积分（自带 sources 时扣 1 积分）。失败的请求不扣费。

对比 Jev 与其他决策模型

还在选模型？接入前先看看 API 可用性、部署方式和基准测试背景。以下对比页为英文。

• Jev 模型是什么？ — 中文介绍：官网、原理、价格与用法。
• JevBench 榜单 — 这些对比引用的独立排行榜，以及怎么解读它。
• Jev vs Imajev-4B — 托管版 Jev 对比一款还能看图的开源 4B 模型。
• Jev vs decider-4b — 托管版 Jev 对比基于 Qwen3.5-4B 的快速开源重建版。
• Jev vs JevK5 — 托管版 Jev 对比一款开源权重的 Qwen3.5-4B 替代品。
• Jev vs Cygnet — 托管版 Jev 对比冻结的 Gemma 4 12B，它在 JevBench 开源权重榜排第十。
• Jev vs Winnow — 托管版 Jev 对比一款还能聊天和看图的本地模型。
• Jev vs OpenJev — 托管版 Jev 对比 OpenJev 项目与自托管方案。
• Jev vs Djev — 对比决策模型的能力与接入方式。
• Jev vs Laya — 模型差异与基准测试背景。
• Jev vs Semif — 模型差异与部署方式。
• Jev vs LLM — 决策模型和聊天大模型、BERT 分类器有什么不同。
• 能在本地运行 Jev 吗？ — 一张表看清开源现状和可自托管的替代方案。

这些页面对比的是决策模型。只要 GET /api/v1/models 列出了 Laya Beta，它就能通过同一个端点调用；其他被对比的模型不在此端点提供。

模型、限制与计费

了解 Laya English 和 Multilingual · Laya API 请求格式与限制（英文）。两者都使用你的 Jev AI 密钥和上方端点。

Inception 的决策模型 Mercury Decide 也可以用这个端点调用：把 model 设为 mercury-decide。单次请求最多 32,768 token，计费方式与 Jev 相同。参见 Mercury Decide API 参考（英文）。

OpenAI Decisions API 背后的模型 GPT-6 Luna 同样可用：把 model 设为 gpt-6-luna。它能读取文本、JSON 和最多 4 张内嵌图片，按其模型倍率计费。参见 GPT-6 Luna API 参考（英文）。

把 model 设为 laya-english 或 laya-multilingual 即可使用 Laya Beta。不传时默认 jev-latest。使用已保存的 judgeId 时同样适用。

Laya English 每个问题总共最多 512 token，Multilingual 最多 1,024 token，包括 state、instructions、标签和框架文本。每个标签最多 48 token，问题和标签合计还有按检查点而定的额外上限。超长输入返回 422 且不扣费，不会被静默截断。用量按每个问题的输入序列计算，重复的 state 也计入。沿用账户现有计费规则，输出 token 为零。