OpenRouter Decisions API：Jev 接入指南

OpenRouter 提供专用 Decisions API 路由

OpenRouter 将 Jev 介绍为结构化决策模型，并提供专用的 alpha Decisions endpoint。目前直连路径为 POST https://openrouter.ai/api/alpha/decisions，OpenRouter 模型 ID 为 typesafe/jev-1.13。请使用 OpenRouter API key，并以其最新 API 参考文档为准核实请求要求。

这个路由与常见的 chat completions 接口不同。请求由 state 和类型化问题组成，响应是结构化答案，而非生成式聊天文本。

POST https://openrouter.ai/api/alpha/decisions
Authorization: Bearer $OPENROUTER_API_KEY
Content-Type: application/json

{
  "model": "typesafe/jev-1.13",
  "state": "客户反馈一笔订单被重复扣款。",
  "questions": {
    "is_duplicate_charge": {
      "type": "noul",
      "instructions": "这是否是重复扣款反馈？",
      "criteria": {
        "true": "客户描述同一订单发生多次扣款",
        "false": "反馈内容并非重复扣款"
      }
    }
  }
}

直连 OpenRouter 与 Decisions API.pro 是两种接入方式

直连 OpenRouter 时，应用向 OpenRouter 发送请求，并自行管理 OpenRouter 凭证和账单关系。使用 decisions-api.pro 时，应用用 Decisions API key 调用 POST https://decisions-api.pro/v1/systemone；本站将判断请求转发给已配置的服务商，并按本站账号与积分规则处理。

请根据账号、运维要求和定价选择接入方式。两项服务相互独立；Decisions API 不是 OpenRouter 产品，也不代表双方存在背书或关联。

在应用场景中验证概率信号

Choice 从开发者定义的选项中选择，Noul 表达真假判断的概率，Score 将状态映射到有序等级。概率是模型输出，需要评估而非保证。请使用代表性样本测试，根据错误成本设置阈值，并为高影响操作保留人工审批。

通过官方文档确认当前 API 细节

服务商接口和模型标识可能变化。上线 OpenRouter 直连集成前，应向 OpenRouter 官方文档和 Jev 当前模型页面核实 endpoint、schema、参数、模型可用性及最新价格。