Jev API 参考

接口与认证

向 Best Jev AI 网关发送 JSON。API key 请求使用 Bearer 认证；请将密钥保留在可信服务端，不要暴露给浏览器。

POST https://bestjevai.com/v1/systemone
Authorization: Bearer <API_KEY>
Content-Type: application/json

请求字段

请求包含模型标识符、供所有问题共享的 state，以及由问题 ID 映射到类型化判断的问题对象。State 可以是字符串、对象或数组。网关每次接受 1–8 个问题，序列化后的请求体不能超过 32 KiB。

• model — 必填字符串；此网关使用 typesafe/jev-1.13。
• state — 所有问题共享的判断上下文。
• questions — 按自定义 ID 索引的非空对象。
• choice — 从 criteria 对象中选择一个命名选项。
• score — 按有序 criteria 数组进行评分。
• noul — 判断一个真假陈述成立的概率；提供 instructions，也可提供 yes/no criteria。

{
  "model": "typesafe/jev-1.13",
  "state": "三次部署失败，生产环境返回 500。",
  "questions": {
    "needs_human": {
      "type": "noul",
      "instructions": "此故障是否需要立即人工处理？"
    }
  }
}

响应字段

网关将 provider 答案和用量放在 data.result 中；API key 请求还会返回 creditsUsed。Choice 和 Score 含概率与置信度；Noul 返回 0–1 数值。根据问题 ID 将答案与请求定义对应起来。

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "answers": {
        "needs_human": { "type": "noul", "noul": 0.94 }
      },
      "usage": { "input_tokens": 42, "output_tokens": 0 },
      "elapsedMs": 180
    },
    "creditsUsed": 1
  }
}

elapsedMs 统计整个网关请求，包括校验和网络耗时；它不是 provider 单独的推理延迟。