怎样获取 Jev：API Key、免费试用和所有接入方式

使用 Jev 的三种方式

Jev 是 TypeSafe 的 System One 模型。目前只有一个公开版本 jev-1.13.0，有三种方式可以用到它：

1. JevStation 免注册试用——在浏览器里用，不需要账号，仅限预设场景。
2. JevStation 账号 + API Key——送 200 点，之后买一次性点数包。
3. TypeSafe 直连——模型官方 API，需要先排 waitlist。

1. 在 JevStation 试验台免费试用

步骤。 打开试验台，选一个预设（比如上面的工单分拣示例），想改的话可以编辑文本，然后运行。

价格。 免费。每个 IP 每天 3 次。

优点。 不需要账号、信用卡或代码。几秒内就能看到真实模型给出的真实概率。

缺点。 问题来自预设，不能修改；可编辑的文本上限 2,000 字符。它能让你看到 Jev 怎么回答，但测不了你自己的用例。

适合还在判断 Jev 值不值得深入了解的人。

2. JevStation 账号和 API Key

步骤。 注册，打开「设置 › API Keys」，创建一个 Key，用它调用 POST https://jevstation.com/api/v1/systemone。同一个账号也可以在试验台里用你自己的问题。

价格。 新账号注册即送 200 点，30 天内有效，无需信用卡、无需自备模型密钥。之后按一次性点数包购买，不是订阅：$9.90 购 5,000 点，或 $15.90 购 12,000 点，24 个月内有效。标准评估（state 不超过 8,000 字符且不超过 5 个问题）消耗 1 点；更大的评估（最多 24,000 字符、12 个问题）消耗 3 点。评估失败自动退点。详见定价。

优点。 不用排 waitlist。按次付点而不是按 token 付费，所以请求的价格不取决于模型怎么切 token。另外还有用来设计问题集的试验台、自动保存的评估记录和失败自动退点。

缺点。 单次调用比直接买 token 贵。按 Jev 的标价，一次典型评估约 $0.00002；而 1 点在小包里是 $0.00198，在大包里是 $0.00133。每个账号的吞吐量有上限，买的点数包越大上限越高；GET /api/v1/systemone 会返回你当前的额度。模型版本由部署固定，请求里的 model 字段会被忽略。

适合想今天就调用 Jev 的开发者、希望 API 旁边还有试验台的团队，以及调用量还不算特别大的用户。

3. TypeSafe 直连

步骤。 加入 TypeSafe 的 waitlist。通过后用 TypeSafe 的 Key 调用 POST https://api.typesafe.ai/v1/systemone。LangChain 为它发布了集成：Python 版 langchain-typesafe，JavaScript 版 @langchain/typesafe。

价格。 按量付费，每百万输入 token $0.042，输出 token 免费。没有自助套餐，也没有免费额度。更高的额度和零数据保留（ZDR）需要找 TypeSafe 销售。

优点。 单次价格最低，速率上限最高（TypeSafe 标称每分钟 1,200 次请求、每秒 250,000 token），并且可以自己控制模型版本，包括 jev-latest 和 jev-preview 这两个别名。

缺点。 需要等待开通。TypeSafe 也说明速率限制正在动态调整，可能随时变化、不另行通知。

适合能等待开通的大调用量生产场景。

调用 JevStation API

下面每个示例都发送上方试用里的那张客服工单，附两个问题。把 $JEVSTATION_API_KEY 换成你创建的 Key。

cURL

curl -X POST https://jevstation.com/api/v1/systemone \
  -H "Authorization: Bearer $JEVSTATION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "I have been trying to connect my Stripe account for 3 days and it keeps failing with invalid redirect. I am losing sales every hour.",
    "questions": {
      "category": {
        "type": "choice",
        "instructions": "Which team should handle this support ticket?",
        "criteria": {
          "billing": "Payments, invoices, refunds or plan changes",
          "integrations": "Connecting or syncing a third-party service",
          "bug": "The product behaves incorrectly",
          "account": "Login, access or account settings"
        }
      },
      "churn_risk": {
        "type": "noul",
        "instructions": "Is the customer at risk of churning?"
      }
    }
  }'

Python（requests）

import os
import requests

resp = requests.post(
    "https://jevstation.com/api/v1/systemone",
    headers={"Authorization": f"Bearer {os.environ['JEVSTATION_API_KEY']}"},
    json={
        "state": "I have been trying to connect my Stripe account for 3 days "
                 "and it keeps failing with invalid redirect. I am losing sales every hour.",
        "questions": {
            "category": {
                "type": "choice",
                "instructions": "Which team should handle this support ticket?",
                "criteria": {
                    "billing": "Payments, invoices, refunds or plan changes",
                    "integrations": "Connecting or syncing a third-party service",
                    "bug": "The product behaves incorrectly",
                    "account": "Login, access or account settings",
                },
            },
            "churn_risk": {
                "type": "noul",
                "instructions": "Is the customer at risk of churning?",
            },
        },
    },
    timeout=30,
)
body = resp.json()
if body["code"] != 0:
    raise RuntimeError(body["message"])

data = body["data"]
print(data["answers"]["category"]["choice"], data["answers"]["category"]["confidence"])
print(data["answers"]["churn_risk"]["noul"])
print("剩余点数:", data["credits"]["remaining"])

Node（fetch）

const res = await fetch('https://jevstation.com/api/v1/systemone', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.JEVSTATION_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    state:
      'I have been trying to connect my Stripe account for 3 days and it keeps failing with invalid redirect. I am losing sales every hour.',
    questions: {
      category: {
        type: 'choice',
        instructions: 'Which team should handle this support ticket?',
        criteria: {
          billing: 'Payments, invoices, refunds or plan changes',
          integrations: 'Connecting or syncing a third-party service',
          bug: 'The product behaves incorrectly',
          account: 'Login, access or account settings',
        },
      },
      churn_risk: {
        type: 'noul',
        instructions: 'Is the customer at risk of churning?',
      },
    },
  }),
});

const body = await res.json();
if (body.code !== 0) throw new Error(body.message);

const { answers, credits } = body.data;
console.log(
  answers.category.choice,
  answers.churn_risk.noul,
  credits.remaining
);

返回什么

响应带一层外壳：成功时 code 为 0，出错时为 -1；message 是 ok 或错误信息；结果放在 data 里。下面的数值只用来展示结构，你实际拿到的数字会不同。

{
  "code": 0,
  "message": "ok",
  "data": {
    "model": "jev-1.13.0",
    "answers": {
      "category": {
        "type": "choice",
        "choice": "integrations",
        "probabilities": {
          "billing": 0.2,
          "integrations": 0.7,
          "bug": 0.08,
          "account": 0.02
        },
        "confidence": 0.6
      },
      "churn_risk": { "type": "noul", "noul": 0.8 }
    },
    "usage": { "input_tokens": 180, "output_tokens": 0 },
    "credits": { "charged": 1, "remaining": 199 },
    "latency_ms": 400
  }
}

Choice 答案包含概率最高的选项、每个选项的概率和置信度。Score 答案包含你所设级别上的一个值、级别图例和置信度。Noul 答案只有一个 0 到 1 的概率，没有置信度。出错时也会返回真实的 HTTP 状态码：Key 缺失或无效返回 401，请求格式错误或过大返回 400 或 413，点数不足返回 402，触发速率限制返回 429，评估失败返回 502（此时点数会退还）。每个字段的说明见文档。

一览对比

获取 API Key 并发出第一次调用

1. 注册。 在 /sign-up 创建账号，自带 200 点，30 天内有效。
2. 创建 Key。 打开「设置 › API Keys」创建一个 Key，保存为环境变量 JEVSTATION_API_KEY，不要写进代码。
3. 检查 Key。 用同样的 Bearer 请求头发送 GET https://jevstation.com/api/v1/systemone。它不扣点，会返回你的套餐、剩余点数和速率限制。
4. 发出第一次调用。 运行上面任意一个示例。它是标准评估，消耗 1 点。

写代码之前，建议先在试验台里把问题设计好：两者用的是同一套契约，你在那里看到的答案就是代码会拿到的答案。问题怎么措辞见设计 Jev 能回答的问题，每次调用背后的 token 成本见一次 Jev 评估到底花多少钱。