Jev API Key 获取与环境配置教程
发出第一个判断题之前，你得先拿到 API Key，并把它放在一个安全的环境里。最快的路径走 OpenRouter——Jev 的主演示渠道：它通过 OpenAI 兼容端点暴露 Jev，你拿到 Key 之后用的就是熟悉的请求结构。这篇教程覆盖拿 Key、接入环境变量、设置额度，以及避免”昂贵事故”的安全习惯。
TL;DR： 在 OpenRouter 注册、充值、创建 API Key；把 Key 存进环境变量（
OPENROUTER_API_KEY），绝不写进代码。第三方列表显示 Jev 约 $0.0462 / 1M input tokens——实时价格以 OpenRouter 模型页为准。官方 TypeSafe AI 渠道及其端点，请以 typesafe.ai 官方文档为准，不要凭空猜端点。
第一步：在 OpenRouter 拿 Key
- 在 OpenRouter 注册并登录。
- 打开控制台的 Keys 页面，创建新的 API Key。
- 立刻复制保存——有些面板只显示一次。丢了就新建一个并作废旧的。
- 找到 Jev 模型页，记下确切的模型 id。写作本文时显示为
typesafe/jev-1.13；slug 会随版本变化，请务必到 OpenRouter 模型页确认确切的 model slug。 - 看一下模型页的 pricing 标签，确认当前 token 单价。
至于官方 TypeSafe AI 渠道（直连 API、企业条款、版本保障），不要猜端点——请看 typesafe.ai 的官方文档，以及介绍 System One 模型与 Jev 的发布公告。两个渠道的取舍在《Jev API 渠道怎么选》里有完整对比。
第二步：把 Key 放进环境变量
唯一不可妥协的规则：Key 永远不进源码、不进会提交到 git 的配置文件、不进聊天记录。用环境变量：
# ~/.zshrc 或 ~/.bashrc —— 会话级导出
export OPENROUTER_API_KEY="sk-or-v1-your-key-here"加完之后重启 shell 或执行 source ~/.zshrc。代码在运行时读取：
import os
api_key = os.environ["OPENROUTER_API_KEY"] # 缺失时直接抛错——这是好事运行时从环境读取是正确默认值：变量缺失时进程会大声失败，而不是默默发出一个没有鉴权的请求。
团队协作场景，优先用 secrets 管理工具（AWS Secrets Manager、Doppler、1Password Connect），在部署时注入变量。n8n 这类本地自动化工具，请用工具自带的凭据存储，不要把 Key 粘贴进工作流节点。
第三步：设置额度与计费
OpenRouter 采用预充值模式：
| 配置项 | 位置 | 建议 |
|---|---|---|
| 余额 | Billing / Credits 页 | 测试阶段小额充值即可 |
| 消费上限 | Key 设置 | 每个 Key 设上限，防止泄漏后掏空账户 |
| Key 级限额 | Keys 页 | 一个项目一个 Key，用量可归因 |
| 自动充值 | Billing 设置 | 管线稳定之后再开 |
一个实用的价格锚点：按列表价约 $0.0462 / 1M input tokens（第三方列表数据——以 OpenRouter 模型页为准），短 prompt 的百万次判断调用是几十美元量级，不是几百。具体算账见《Jev 成本与延迟》。
第四步：验证 Key 可用
接线之前先做一次最便宜的调用：
# Confirm the exact model slug on the OpenRouter model page
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "typesafe/jev-1.13",
"messages": [{"role": "user", "content": "Judgment question: is the sky blue?"}]
}'返回 200 且 message content 里有结构化答案，说明 Key、余额、模型 slug 三者都对了。
解析后的答案——示例数据（example fixture），正式字段名以官方文档为准：
{
"answer": "yes",
"confidence": 0.99,
"rationale": "Visible-sky blue coloration is the expected answer to this common-knowledge question."
}如果拿到 401，是 Key 错了或没传上；404 多半是模型 slug 不对。两者在《Jev 常见报错排查》里都有对应的修复步骤。
真正有用的安全习惯
- 一个项目一个 Key。 用量异常时你知道查谁，作废时也是精确打击。
- 每个 Key 设消费上限。 没有上限的泄漏 Key 就是一张敞开的账单。
- 有疑点立刻轮换。 Key 出现在日志、截图或提交里，马上作废重建。
- 绝不提交
.env文件。 第一天就把它写进.gitignore。 - 把 Key 当密码对待——它就是密码，背后还挂着你的信用卡。
Key 验证通过后，接着看《Jev API 教程：10 分钟发出第一次调用》了解完整的请求解读，或看 ticket triage 那个 case 了解 Key 在真实工作流里的用法。
本文适用版本 Jev 1.13。