决策 API

提交背景和问题，获取结构化决策。

在账户设置创建 API Key 并购买积分。请求需携带 Authorization: Bearer YOUR_API_KEY 和唯一的 Idempotency-Key，费用从密钥所属用户余额扣除。不要在浏览器代码中暴露密钥。

从一个 Jev API 示例开始接入

通过 cURL 调用 iajev REST API，以 JSON 获取选项、概率与置信度。

请求

curl https://iajev.com/api/v1/decisions/run \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: YOUR_UNIQUE_REQUEST_ID' \
  -H 'Content-Type: application/json' \
  --data '{
  "state": {
    "message": "我上个月的订阅被扣了两次款，到现在还没有收到退款。",
    "plan": "pro",
    "country": "CN"
  },
  "decision": {
    "type": "choice",
    "question": "哪个团队应该处理此请求？",
    "choices": [
      "账单",
      "技术",
      "销售",
      "欺诈"
    ]
  }
}'

请求字段

state.message: 必填文本，1–8,000 个字符。
state.<field>: 除 message 外，最多可添加 5 个补充字段。字段名为 1–40 个字符；值可为最多 300 个字符的文本、有限数值或布尔值。不支持嵌套对象。
decision.type: 使用 "choice"。此 API 暂不支持评分或布尔类型请求。
decision.question: 必填文本，1–300 个字符。
decision.choices: 2–8 个不重复的非空字符串，每项最多 80 个字符。

响应字段

decision: 最终选中的选项。
confidence: 独立的置信度估计，介于 0 和 1 之间。
results: 各选项及其概率，按概率从高到低排列。
meta: 响应耗时（毫秒）及用于排查问题的请求 ID。
billing: 实际扣除的 credits、inputTokens 和 outputTokens。

错误与限制

400: 背景、问题、选项或 JSON 格式无效。
401: API Key 缺失、无效、过期或已撤销。
402: 可用积分不足。
403: 账户未验证或已被禁用。
409: 请求处理中、已失败或相同幂等键被用于不同请求。
413: 请求超过 16,000 个 UTF-8 字节（包含所有字段）。
415: Content-Type 必须为 application/json。
429: 已达到预览版用量限制，请遵循 Retry-After 响应头。
502 / 503 / 504: 决策服务不可用或超时，请勿立即反复重试。

响应结构

{
  "decision": "Billing",
  "confidence": 0.8,
  "results": [
    { "value": "Billing", "probability": 0.87 },
    { "value": "Technical", "probability": 0.10 },
    { "value": "Sales", "probability": 0.02 },
    { "value": "Fraud", "probability": 0.01 }
  ],
  "meta": { "latencyMs": 218, "requestId": "…" },
  "billing": { "credits": 1, "inputTokens": 380, "outputTokens": 0 }
}

查询可用积分

curl https://iajev.com/api/v1/credits -H 'Authorization: Bearer YOUR_API_KEY'

每次付费调用预留 32 积分，成功后按每开始 1,000 个输入 token 扣 1 积分，最少 1 积分；余量释放，失败不扣费。网络异常时使用相同 Idempotency-Key 重试。409 REQUEST_PENDING 表示稍后用相同 key 重试，REQUEST_FAILED 表示已失败，可使用新 key 重新调用。

请勿提交密钥或不必要的个人信息。背景信息将用于推理。登录用户和 API 请求的输入、结果和扣费记录保存在私有历史中；保存的决策也保留输入背景。匿名预览仅记录限流计数，不保存决策历史。