决策 API

选择决策模型

现有请求继续使用 Jev。接口地址、API Key、决策类型和 Jev 响应结构不变。仅在需要 Clef 时添加 model: "clef"；省略 model 或传入 "jev" 都使用 Jev。

Jev：每开始 1,000 输入 tokens 扣 1 积分。Clef：每开始 100 输入 tokens 扣 1 积分，均至少扣 1 积分。实际输入用量包含问题和选项定义，不仅是上下文文本。

Jev 预留最多 32 个可用积分，至少需要 1 积分。Clef 根据完整文本和图片尺寸动态估算预留，调用前余额须覆盖本次预估。完成后按实际输入用量扣费，最高不超过预留金额；余量释放，估少的差额由 iajev 承担，失败不扣费。

文本估算使用 state 与映射后的上游 questions 的 JSON，包含选项标签及描述：max(Unicode 字符数 × 2, UTF-8 字节数) + 200 tokens。图片按至少放大至 65,536 像素后的 32 像素网格估算，增加 25% 余量及每图 16 tokens。总估算封顶 65,536 tokens，再按每 100 tokens 向上取整预留积分。这是经验估算，不是 tokenizer。GET /api/v1/models 返回估算版本、参数和最大预留，Clef billing 改用 reservationMode、maxReservationCredits、estimation 和 chargeCappedAtReservation，替代固定 reservationCredits/minimumAvailableCredits。

Jev 保持 8,000 字符 / 16,000 字节限制。Clef 接收最多 1 MiB 的 JSON 编码文本，文本、图片与问题共享 65,536-token 模型窗口；超长状态可能被上游截断。均为每次一个问题、最多 8 个选项或评分等级。Clef 整体请求最多 13 MiB，不支持视频。

Clef 图片：可选 images 数组，支持 data:image/png;base64,...（也支持 JPEG/WebP）或 {content_type, base64} 对象。最多 4 张，每张最多 4 MiB / 16 MP，总解码大小最多 8 MiB。不接受远程 URL。图片参与幂等校验，不保留于历史或保存配置；重试须提交原图片。Clef 超时 90 秒，Jev 仍为 15 秒。 网页试用通过内部服务读取三个固定 iajev CDN 示例，缩至 512px 后提交。API/MCP 仍须传入嵌入图片，不接受远程 URL。

GET /api/v1/models 使用现有 API Key，不消耗积分；调用前检查 available。MCP 可使用免费的 list_models 工具，再向 run_decision 传入 model。认证方式与权限范围不变。

结果不确定时使用原幂等键重试。同一键更换模型返回 IDEMPOTENCY_CONFLICT。已完成的调用始终重放原结果与扣费，即使之后停用 Clef；不会自动切换到其他模型。

仅 Clef 响应新增 meta.model 及 billing.pricingVersion、estimationVersion、estimatedInputTokens、reservedCredits、waivedCredits。waivedCredits 为实际用量超出预留时平台承担的积分差额；billing.credits 是实际扣款。Jev 响应不变。MODEL_UNAVAILABLE（503）表示 Clef 未启用。

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

curl https://iajev.com/api/v1/decisions/run \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: clef-example-001' \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "clef",
  "state": {
    "message": "我的款项已经连续三天支付失败，请今天帮忙处理。"
  },
  "images": [
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+jRZkAAAAASUVORK5CYII="
  ],
  "decision": {
    "type": "noul",
    "question": "这条请求是否需要紧急处理？"
  }
}'

{
  "model": "clef",
  "state": {
    "message": "我的款项已经连续三天支付失败，请今天帮忙处理。"
  },
  "images": [
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+jRZkAAAAASUVORK5CYII="
  ],
  "decision": {
    "type": "noul",
    "question": "这条请求是否需要紧急处理？"
  },
  "idempotency_key": "clef-example-001"
}

真假概率与评分示例

{
  "state": {
    "message": "我的款项已经连续三天支付失败，请今天帮忙处理。"
  },
  "decision": {
    "type": "noul",
    "question": "这条请求是否需要紧急处理？"
  }
}

{
  "decision": 0.95,
  "confidence": null,
  "results": [
    {
      "value": "true",
      "probability": 0.95
    },
    {
      "value": "false",
      "probability": 0.05
    }
  ],
  "meta": {
    "latencyMs": 218,
    "requestId": "…"
  },
  "billing": {
    "credits": 1,
    "inputTokens": 380,
    "outputTokens": 45
  }
}

{
  "state": {
    "message": "我的款项已经连续三天支付失败，请今天帮忙处理。"
  },
  "decision": {
    "type": "score",
    "question": "这条请求有多紧急？",
    "criteria": [
      "低紧急度",
      "中等紧急度",
      "高紧急度"
    ]
  }
}

{
  "decision": 1.8,
  "confidence": 0.9,
  "results": [
    {
      "value": "低紧急度",
      "probability": 0.05
    },
    {
      "value": "中等紧急度",
      "probability": 0.1
    },
    {
      "value": "高紧急度",
      "probability": 0.85
    }
  ],
  "meta": {
    "latencyMs": 218,
    "requestId": "…"
  },
  "billing": {
    "credits": 1,
    "inputTokens": 380,
    "outputTokens": 45
  }
}