文档 · 快速开始

创建 API 密钥并选择线路

2026-11-09

密钥抽屉的填写步骤、每条线路的含义，以及一把密钥会碰到的三种 403。

在侧栏打开 API 密钥，点创建 API 密钥。

表单各项

名称：随便起，占位符给的例子是 production-backend。
分组：密钥按哪条线路计费。默认没有选中任何一项，不选就保存会提示请选择分组。每一行右侧有个 N 个模型按钮，点开就是该线路的价格表（美元 / 每 100 万 tokens、美元 / 每张图片或美元 / 每秒），有长上下文档位的模型下面多一行长上下文。
额度：不限额度打开，或者关掉后填额度（USD），花到这个数，密钥就停。
有效期：填过期时间，或者选预设的永不、1 小时、1 天、1 个月。
数量（只在创建时出现）：一次最多 50 把，第一把用你填的名称，其余的名称后面加随机后缀。
高级设置，默认收起：模型限制和 IP 白名单（支持 CIDR），默认都留空。

点保存更改。密钥以 sk- 开头。

线路怎么选

自动路由排在第一位，一把密钥覆盖整个模型目录。每个请求送到当下能提供该模型的最低价线路，通常是共享池；共享池暂时提供不了，就走官方线路，按官方线路的价格扣，所以同一把密钥不同请求的计费线路可能不一样。用量日志里每条请求显示的是实际计费的线路，在分组一栏。

Claude、OpenAI、Grok：各有一个共享池（claude-shared、openai-shared、grok-shared），牌价的 50%；还有一条官方线路（claude-official、openai-official、grok-official），牌价的 90%。文本模型只在自家厂商的这两条线路上出售。Grok 的官方线路同时是 grok-imagine-video-1.5 唯一的线路，按秒计价。
Claude 特价线路（claude-special，标注仅 Opus 5.5 · 限时 · 经常不可用）：只卖 claude-opus-5-5 的临时线路，每百万 Token 输入 $0.45、输出 $0.90、缓存读取 $0.10、缓存写入 $0.20（1 小时缓存写入 $0.30）。它经常长时间不可用、不保证可用性，会在每个请求里加入自己的系统提示词，失败时不兜底，自动路由也不会选它；选中后列表下方会显示它的条款。详见 Claude Opus 5.5 特价线路。
OpenAI 的图片生成（image）：gpt-image-2.6-sunburst 和 gpt-image-2.6-flare 唯一的线路，按张、按尺寸计价。
GLM 的私有部署（z-official）：跑 GLM-5.3-Abliterated，微调过的 GLM-5.3，只支持文本；还有 GLM-5.3-Flash-Abliterated，能看图。
Kimi 的私有部署（kimi-official，标注私有部署 · 固定价格）：跑 kimi-k3.1-pro。
DeepSeek 的私有部署（deepseek-official，标注私有部署 · 固定价格）：跑 deepseek-flash-Abliterated 和 deepseek-flash-fast，后者是标准权重的 DeepSeek V4.1 Flash 1017。
TypeSafe 的官方线路（typesafe-official，标注官方密钥 · 固定价格）：跑 jev-1.14.0，另列一组备用价，只用于极少数由备用线路处理的请求。这种密钥的完整 API 密钥弹层里还有 Jev 一键接入。

GLM、Kimi、DeepSeek 的路由 ID 为现有密钥保留，但这些模型都不经过厂商官方 API，价格全天固定（GLM-5.3-Abliterated、kimi-k3.1-pro 和 deepseek-flash-Abliterated 另列一组备用价，只用于极少数由备用部署处理的请求），线路说明里有完整价目。

Claude、OpenAI、Grok 未配置专属线路时，官方线路的请求会回退到共享池；需要专属的官方价线路，写信到 support@topxai.xyz。

自动切换备用线路

配置了备用的文本线路，按模型和 API 协议（Chat Completions、Messages、Responses）分别统计故障。默认三个不同请求连续出现上游故障后，新请求立即改走备用；出现一次失败时，后台就会开始检查这条线路。只要还没有向你输出内容，失败的请求会立即重试备用。

主线故障期间，中转站在后台持续检查，不会让客户请求去试主线。后台检查两次通过后，同一时间只放一笔请求试主线；两次成功且间隔至少 30 秒，恢复主线优先。刚恢复又出故障的线路会在备用上停留更久，因为每切一次提示词缓存都要重建。正在输出的请求保持原连接。依赖某个上游会话状态的续接请求，可能无法换线路。

参数错误、余额不足、内容拒绝和用户主动取消不计入连续故障。密钥和接口地址无需更换；线路另列备用价时，每笔请求仍先试主线，只有主线答不了的请求才转备用并按备用价计费，不另收切换费。图片生成和异步视频任务不适用这套文本线路规则。

三种 403

请求到厂商之前要过三道检查，不通过都返回 HTTP 403：

Model is not offered by this service：模型 ID 不在目录里。
Model is not available on this API key route：这把密钥的线路不提供这个模型，比如拿 Claude 密钥调 GPT 模型。
This token has no access to model <name>（中文环境下是「该令牌无权访问模型 <name>」）：密钥的模型限制没包含它。在选择模型（留空表示不限）里勾选允许的模型；jev-latest 和 jev-preview 在这一步算作 jev-1.14.0。

IP 白名单每行一个 IP 或 CIDR 段；IP 可以伪造，所以要配合 nginx 或 CDN 这类网关一起用。

创建 API 密钥并选择线路

表单各项

线路怎么选

自动切换备用线路

三种 403

相关