Jev API · 接入指南

Jev API:结构化决策接口指南

通过 decisions-api.pro 的 Decisions API 接口使用 Jev 决策模型。提交 state 与类型化问题,并在自己的服务中处理结构化结果。

此 Jev API 接口提供什么

Jev 是 TypeSafe 的 System One 决策模型,面向答案范围明确的问题并返回类型化结果。decisions-api.pro 的 Jev API 通过 POST /v1/systemone 提供托管的 System One 路由,使用 Decisions API key 认证,并按请求中的问题 ID 返回答案。

本站托管接口属于一种服务接入方式,和直接调用 TypeSafe 或使用 OpenRouter 自己的 API key 与 endpoint 不同。具体用量、凭证和账号关系取决于所选调用路径。

围绕明确的答案空间编写问题

代码需要从有限集合中选一个结果时使用 Choice;真假判断使用 Noul;有序量表评分使用 Score。state 可以是文本或结构化 JSON,每个问题包含说明和判断标准。明确标准有助于校验与评估输出。

调用 Decisions API 的 Jev 接口

在 Decisions API 账号中创建 API key,将密钥保存在服务端的密钥存储中,再发送带 Bearer 认证的请求。下方模型别名是本站配置使用的别名,不代表同一标识可用于所有 Jev 服务商。

curl -X POST https://decisions-api.pro/v1/systemone \
  -H "Authorization: Bearer $DECISIONS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "客户反馈一笔订单被重复扣款。",
    "model": "jev-latest",
    "questions": {
      "route": {
        "type": "choice",
        "instructions": "这个案例应交给哪个团队?",
        "criteria": {
          "billing": "支付、退款或重复扣款",
          "technical": "产品故障或技术问题",
          "account": "登录或账户访问"
        }
      }
    }
  }'

自动执行前先评估判断结果

检查答案与概率字段,处理 HTTP 错误和积分不足,并用有代表性的标注数据选择阈值。模型响应本身不应直接授权退款、修改账户等重要操作;请保留确定性校验,并在需要时加入人工复核。