文档 · 快速开始

创建 API 密钥并选择线路

2026-09-18

密钥抽屉的填写步骤、每条线路的含义，以及一把密钥会碰到的三种 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 唯一的线路，按秒计价。
OpenAI 的图片生成（image）：gpt-image-2.5-sunburst 和 gpt-image-2.5-flare 唯一的线路，按张、按尺寸计价。
GLM 的私有部署（z-official）：跑 GLM-5.3-Abliterated，微调过的 GLM 5.3，私有部署，只支持文本，高于牌价。
Kimi 的官方线路（kimi-official）：跑 kimi-k3，牌价的 80%。
TypeSafe 的官方线路（typesafe-official，标注官方密钥 · 牌价的 107%）：跑 jev-1.13.0。这种密钥的完整 API 密钥弹层里还有 Jev 一键接入。

未配置专属线路时，官方线路的请求会回退到共享池；需要专属的官方价线路，写信到 support@topxea.com。

请求到厂商之前要过三道检查，不通过都返回 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.13.0。

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