文档

从测试台到生产环境所需的一切。

快速入门

创建账号，在控制台中创建 API 密钥，然后发送你的第一个请求。密钥只显示一次——请将其保存在服务端的密钥存储中，切勿放在浏览器代码里。

curl

curl https://jevai.website/api/v1/systemone \
  -H "Authorization: Bearer $JEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "state": "The deployment failed three times and production is returning 500s.",
  "questions": {
    "needs_human": {
      "type": "noul",
      "instructions": "Should this be escalated to a person?"
    }
  }
}'

请求

发送一个 JSON 请求体，包含 `state` 和一个由具名问题组成的 `questions` 映射。可选的 `model` 字段仅为兼容而保留，会被忽略。 `state` 可以是字符串、字符串数组或 JSON 对象，最长 100,000 个字符。

响应

答案以你的问题名称作为键。每个响应都带有一个 `request_id`，联系支持时可提供该 ID。

问题类型

每个问题都包含 `type` 和 `instructions`；选择题和评分题还需要一组 `criteria`。是 / 否。返回 `noul`：答案为“是”的概率。可选提供包含 `true` 和 `false` 描述的 `criteria`。从 2–20 个带标签的选项中选出一个。返回 `choice`、每个选项的 `probabilities` 以及 `confidence`。将状态放到一个 2–10 级的有序量表上。返回连续的 `score`（0 = 第一级）、`probabilities`、`legend` 和 `confidence`。

错误

错误始终使用相同的结构。请根据 `error.code` 进行分支处理，而不是依赖错误消息文本。对 `429`、`502` 和 `529` 使用指数退避重试。对于 `401`、`402` 或 `422`，请先修改请求再重试。

HTTP	代码	含义
401	missing_api_key / invalid_api_key	API 密钥缺失、无效或已吊销
402	insufficient_credits	工作区额度不足
422	invalid_request	JSON 格式错误或问题定义无效
429	rate_limited	已达到速率或并发限制
502	upstream_error	模型服务商出错或超时
529	upstream_overloaded	模型服务商过载

额度与限制

1 额度等于 1,000 个输入 token。最终按真实 token 数向上取整，最少 1 额度。调用前会先预留，失败则退回。并发数和每分钟请求数取决于你工作区的套餐。超出限制时将返回 `429`，并附带 `Retry-After` 响应头。

数据处理

我们会把请求转发给模型以生成答案，不保留请求内容。我们只存储请求元数据（时间、状态码、额度、token 数量）用于用量记录。