Jev 使用教程

先在线体验，再创建自己的 key

打开 jevmodel.org 在线体验，先测试一个范围很窄的判断。结果可用后登录账户控制台，创建 API key，并在服务端保存为环境变量 JEVMODEL_API_KEY。

答案集合要小而稳定。字段名按你的代码要走的分支来命名，而不是一个模糊的主题。

import os
import requests

response = requests.post(
    "https://jevmodel.org/v1/systemone",
    headers={"Authorization": f"Bearer {os.environ['JEVMODEL_API_KEY']}"},
    json={
        "state": "I was charged twice. Please fix this ASAP.",
        "model": "jev-latest",
        "questions": {
            "category": {
                "type": "choice",
                "instructions": "What is this ticket about?",
                "criteria": {"billing": "payments", "technical": "broken product", "other": "other"},
            },
        },
    },
    timeout=15,
)
print(response.json())

HTTP 接口约定

已经在发送这种请求的开源仓库 ↗都列在 Jev 项目目录里。

向 https://jevmodel.org/v1/systemone 发送一个 POST 请求。model 可用 jev-latest 或固定版本；state 可以是字符串或 JSON 值，序列化后最多 8,000 字符；questions 是包含 1–8 个具名 choice、score 或 noul 问题的对象。

• jevmodel.org 对每个 API key 的限制是每分钟 120 次请求。
• 每次成功请求按输入 token 扣费；上游失败的请求会退款，重试时建议添加 Idempotency-Key 请求头。
• 在代码里设置置信度阈值。Jev 让分支更简单，但并非零风险。

curl -X POST https://jevmodel.org/v1/systemone \
  -H "Authorization: Bearer $JEVMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-latest",
    "state": "Customer: I was charged twice and I am furious.",
    "questions": {
      "topic": {
        "type": "choice",
        "instructions": "What is the issue about?",
        "criteria": { "billing": "money problems", "bug": "broken product" }
      },
      "urgent": {
        "type": "noul",
        "instructions": "Escalate to a human now?"
      }
    }
  }'

拿到答案之后怎么做

在应用代码里分支。如果 topic 是 billing 且 escalate.noul 超过你的阈值，就转人工；如果置信度低，把同样的状态交给更大的模型或人工审核。记录输入、输出、版本和下游结果，才能判断 Jev 是真的在帮你，还是只是“看起来很果断”。