Jev API 快速开始

1. 创建密钥并选择安全的运行环境

在 Best Jev AI 账户中创建 API key。将它保存在服务端环境变量或密钥管理器中；不要放进浏览器 JavaScript、移动端应用包或代码仓库。

• 接口：POST https://bestjevai.com/v1/systemone
• 认证：Authorization: Bearer <API_KEY>
• 模型：typesafe/jev-1.13

2. 发送一个边界清晰的 Choice 判断

提供判断所需的 state，再定义一个有限选项的问题。问题 ID 会成为响应中的键，因此建议使用稳定且易读的名称。

curl https://bestjevai.com/v1/systemone \
  -H "Authorization: Bearer $JEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "typesafe/jev-1.13",
    "state": "客户的一笔订单被重复扣款。",
    "questions": {
      "next_step": {
        "type": "choice",
        "instructions": "客服下一步应该做什么？",
        "criteria": {
          "refund_review": "核对重复扣款并评估退款",
          "request_receipt": "请客户提供收据",
          "billing_support": "转交账单支持团队"
        }
      }
    }
          }'

Python 调用方式

服务端 Python 程序也可以使用相同的 JSON 协议。请从环境变量读取 API key，不要把密钥写进脚本。

import os
import requests

response = requests.post(
    "https://bestjevai.com/v1/systemone",
    headers={"Authorization": f"Bearer {os.environ['JEV_API_KEY']}"},
    json={
        "model": "typesafe/jev-1.13",
        "state": "客户的一笔订单被重复扣款。",
        "questions": {
            "next_step": {
                "type": "choice",
                "instructions": "客服下一步应该做什么？",
                "criteria": {
                    "refund_review": "核对重复扣款",
                    "request_receipt": "请客户提供收据",
                    "billing_support": "转交账单支持团队",
                },
            }
        },
    },
    timeout=20,
)
response.raise_for_status()
result = response.json()["data"]["result"]

3. 读取答案，并由你的代码决定下一步

成功的 API key 请求会返回标准响应 envelope。通过问题 ID 读取答案，检查概率分布，并在应用中设置动作阈值。

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "answers": {
        "next_step": {
          "type": "choice",
          "choice": "refund_review",
          "probabilities": {
            "refund_review": 0.81,
            "request_receipt": 0.07,
            "billing_support": 0.12
          },
          "confidence": 0.76
        }
      },
      "usage": { "input_tokens": 42, "output_tokens": 18 },
      "elapsedMs": 184
    },
    "creditsUsed": 1
  }
}

以上数值仅为示例。概率是模型信号，不是准确性保证或授权决定。