接入文档 · JevHub

快速开始

两种方式任选：自己写代码，或者把下面的提示词复制给 AI 编程助手（Claude Code、Codex、Cursor 等）让它写。Key 在「余额」页面复制，设置为环境变量 JEVHUB_API_KEY。

给开发者

export JEVHUB_API_KEY="sk-jh-..."

curl -X POST \
  https://api.jevgo.cn/v1/systemone \
  -H "Authorization: Bearer $JEVHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-latest",
    "state": "我被重复扣费了，请退款",
    "questions": {
      "billing": {
        "type": "noul",
        "instructions": "和账单有关吗？"
      }
    }
  }'

下载完整接口文档查看完整文档 →

给 AI Agent

请先阅读 https://api.jevgo.cn/skill.md
按里面的说明通过 JevHub 调用 Jev 模型，帮我实现：

【在这里写你的需求，例如：把客服消息分成退款 / 物流 / 其他三类，并判断紧急程度】

要求：
1. API Key 只从环境变量 JEVHUB_API_KEY 读取，不要写进代码；
2. 遇到 429 / 529 按文档指数退避重试。

下载 Skill 包查看 SKILL.md

基础信息

Base URL	https://api.jevgo.cn
接口	POST /v1/systemone　GET /v1/models
鉴权	Authorization: Bearer sk-jh-...
模型	jev-latest

curl 示例

一次请求可以同时问多个问题，它们并行回答，按问题名返回。

curl https://api.jevgo.cn/v1/systemone \
  -H "Authorization: Bearer $JEVHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-latest",
    "state": "我这个月被重复扣费了，请把多扣的退给我。",
    "questions": {
      "billing": { "type": "noul", "instructions": "这条消息和账单有关吗？" },
      "tone": {
        "type": "choice",
        "instructions": "这条消息的语气是？",
        "criteria": { "angry": "生气或敌意", "calm": "平静或礼貌", "excited": "兴奋或期待" }
      },
      "urgency": {
        "type": "score",
        "instructions": "这条消息有多紧急？",
        "criteria": ["可以等", "本周内处理", "今天必须处理"]
      }
    }
  }'

Python 示例（requests）

import os, requests

BASE_URL = "https://api.jevgo.cn"
API_KEY = os.environ["JEVHUB_API_KEY"]  # sk-jh-...

resp = requests.post(
    f"{BASE_URL}/v1/systemone",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "jev-latest",
        "state": {"subject": "重复扣费", "message": "我被扣了两次，请退款"},
        "questions": {
            "billing": {"type": "noul", "instructions": "这条消息和账单有关吗？"},
        },
    },
    timeout=30,
)
resp.raise_for_status()
data = resp.json()
print(data["answers"]["billing"]["noul"])   # 0.98
print(resp.headers["X-JevHub-Charge-USD"])  # 本次额度消耗（美元）

问题类型

类型	用途	返回
noul	是 / 否判断	noul：为「是」的概率 0–1
choice	从给定选项中选一个（≤255 个）	choice、probabilities、confidence
score	按有序等级打分（2–10 级）	score、probabilities、legend

错误码

官方错误（如 422）原样返回；本站自身的错误返回 {"detail": "...", "code": "..."}。

状态码	含义	建议
401	缺少或无效的 API Key	检查 Authorization 头
402	额度用完或套餐到期	在「兑换」页兑换新卡密
403	账号被封禁	联系客服
422	请求格式校验失败	按返回的 detail 修正字段，不扣费
429	请求过于频繁（超过你的 QPS / 并发限制）	指数退避后重试
529	服务繁忙（已自动切换线路）	稍后重试，官方 SDK 会自动重试

计费说明

每次成功调用按本站计费标准从额度扣减；失败请求（4xx / 5xx）不扣费。每次调用的额度消耗（美元）可在「余额 → 调用明细」逐条查看，响应头 X-JevHub-Charge-USD 也会返回本次消耗。