API Key 与路由分组
适用角色：主用户 更新日期：2026-08-06
API Key 是调用模型的身份凭证。本页说明 Key 创建、分组绑定、普通模型名路由和分组标识路由。
子用户也能自己建 Key，操作和你一样，只是能选的分组限于你授权的范围。子用户视角的说明见 子用户手册 · API Key 管理。
一、建 Key 时必须选一个「分组」
分组可以理解成不同的「服务套餐」：同一个模型，可能有好几个分组都能提供，背后接的线路、价格可能不一样。分组由平台统一维护。分组有两种类型：标准（余额型，调用扣组织的积分余额（总额度池））和订阅（订阅型，调用扣订阅份额度），选了哪种分组就走哪种计费逻辑。关于订阅制的详细说明见 订阅管理与成员分配。
创建 Key 时需要选择一个路由分组（页面会预选第一个可用分组，未选择时无法提交）。绑定后，使用普通模型名发起的请求会优先进入该分组。
那「模型名调用」到底走哪个分组？平台按这个顺序决定：
- Key 需要先绑定分组。Key 未绑定分组时，普通模型名调用直接被拒，不会进入默认路由。
- 目标模型在 Key 绑定分组内时，直接走该分组。
- 目标模型不在绑定分组内时，才按「当前用户默认配置 → 主用户默认配置」查找可承载该模型的回退分组；均无可用候选时调用被拒。
平台不会随机挑选分组；绑定分组被撤权、禁用或订阅失效时也会直接报错，不以回退掩盖权限变化。
Key 绑定分组后，可以直接使用模型调用名发起请求。
二、创建 / 编辑 Key
- 进「API Key」页（
/keys），点右上角「创建 API Key」。 - 在弹窗里填：
| 配置项 | 说明 |
|---|---|
| 名称 | 给 Key 起个名（占位「我的 API Key」） |
| 路由分组（模型名称走此分组） | 必选。挑一个分组，以后用模型名调用就走它。页面提示：不带分组标识的模型名会走这个分组；不选则模型名调用会被拒。带分组标识的写法始终按分组标识走，不受这项影响。下拉里会显示每个分组的折扣标签和计费类型（订阅额度 / 余额），方便你选之前就看清成本 |
| 自定义 API Key | 开关（仅建 Key 时有）。打开可自己指定 Key 内容，仅允许字母、数字、下划线和连字符，最少 16 个字符；不打开就系统随机生成 |
| IP 限制 | 开关。限定只有指定来源网络能用这把 Key（白名单 / 黑名单，每行一个 IP 或网段） |
| 额度限制 | 给这把 Key 单独设消费上限（积分），填 0 = 不单独限（此时仍受子用户 / 组织的额度约束） |
| 速率限制 | 开关。限制这把 Key 在 5 小时 / 1 天 / 7 天窗口内最多花掉多少积分。界面上的输入框标签是「Key 限额（5 小时）(积分)」「Key 限额（日）(积分)」「Key 限额（7 天）(积分)」，提示语「设置此 API Key 在指定时间窗口内的最大消费额。0 = 无限制。」 |
| API Key 有效期 | 开关。设到期时间（7 / 30 / 90 天或自定义），到期自动失效 |
点「创建 API Key」后弹出的配置窗口：
- 提交后系统会显示完整的 Key，请马上复制保存。完整 Key 只在这一次能看全，之后列表里只显示打码的样子（如
sk-062...8c96）。没存住就只能删掉重建。
编辑已有 Key 时可以改名、换分组、改状态，以及开关 IP / 额度 / 速率 / 有效期限制。下拉里没有「不绑定」这个选项，Key 一旦绑定分组后就不能解绑。
组织余额不足时，按量型 Key 即使创建成功也无法调用。可以先充值，或选择当前有效的订阅分组。
三、Key 列表怎么看、怎么管
「API Key」页列出你名下所有 Key：
| 列 | 说明 |
|---|---|
| 名称 | 你起的名字。注定调用失败的 Key 会加 ⛔ 和删除线，见下方「哪把 Key 现在能用」 |
| API Key | 打码的 API Key（如 sk-062...8c96），可复制 |
| 分组 | 这把 Key 绑的分组；没绑的显示橙色「未绑定分组，请编辑绑定」。设置了折扣的分组还会显示折扣标签 |
| 计费来源 | 这把 Key 走「订阅额度」还是「余额」，独立成列 |
| 当前并发 | 此刻正在同时处理的请求数 |
| 用量 | 这把 Key 花了多少积分 |
| 过期时间 | 永久有效或某个到期日 |
| 状态 | 活跃 / 已禁用 / 额度耗尽 / 已过期 |
| 创建时间 | 建这把 Key 的时间 |
| 操作 | 使用 API Key、导入到 CCS、启用 / 禁用、编辑、删除 |
（「速率限制」「上次使用时间」「最近使用 IP」等列默认收起，点工具栏「列设置」可显示。「导入到 CCS」可被平台开关隐藏，没开通时看不到这一项。）
API Key 管理页面：
每把 Key 能做的操作：
- 使用 API Key：弹出接入配置，按不同工具（如 Claude Code、Codex 等）给好要填的地址和这把 Key，还分了 Mac/Linux、Windows CMD、PowerShell 等写法，按页面内容填写即可。（没绑分组的 Key 点这里不给配置，会提示先绑分组。）
- 导入到 CCS：把这把 Key 一键导入 CCS。该入口受平台开关控制，没开通时不显示。
- 启用 / 禁用：禁用后立刻不能用，再启用恢复。
- 编辑：改名、换分组、改状态和各类限制。
- 删除：永久删除，删了无法恢复。
列表里也能直接给 Key 内联切换分组，但没有「不绑定」这个选项——不管是列表内联切换还是「编辑」弹窗，Key 一旦绑定后都不能解绑，只能换成另一个分组。切换分组的下拉面板同样会显示折扣标签。
哪把 Key 现在能用
能不能调用是按每把 Key 绑定的分组单独判定的，不是整个账户一起断。组织余额不足时，绑了订阅型分组的 Key 照常能调，绑了按量型分组的才失败。API Key 页会在三处标出来：
- 顶部汇总条（只在余额不足时出现）：「N 个 API Key 可正常调用（订阅额度）· M 个调用将失败」，并说明「订阅型 API Key 不受余额影响，可继续使用」。全部失败时改显示「全部 M 个 API Key 当前均无法调用」，按钮是「去充值」。
- 「计费来源」列：显示该 Key 使用订阅额度还是组织余额。
- 行内标记：当前不可用的按量型 Key，名称加 ⛔、加删除线、变淡，并补一句「余额不足，调用将失败」；订阅型 Key 标「✓ 可正常调用」。
用户在 IDE 里吃了 403 来自查时，这一页是唯一能给出准确答案的地方，仪表盘的汇总数字不区分单把 Key。
四、默认模型配置：给模型名配默认分组
「默认模型配置」页（/default-model-config）的作用是：当已绑定分组的 Key 调用一个不在该绑定分组内的模型时，为该模型指定可回退的分组。它不能让未绑定分组的 Key 使用普通模型名调用。
- 这个页面一直都在、随时能进，不受任何开关影响。
- 页面是个表格：模型 / 供应商 / 默认分组 / 折扣 / 操作。可以搜模型名。
- 支持「按供应商批量设置」，一次给某供应商下所有模型配默认分组，批量设置有二次确认，且覆盖后不可撤销，慎点。
默认模型配置页面：
按供应商批量设置默认分组：
五、进阶：分组标识路由（多数人用不到）
平台会给每个分组配一串短短的「分组标识」（比如 A2C4E6G8）。把分组标识加在模型名前面，就能临时点名走那个分组，不用改默认配置。完整写法长这样：
A2C4E6G8/kimi-k3用这个进阶功能有几个前提和要点：
- 需要开「分组标识路由」开关。 这个开关只有你（主用户）能开关，入口在「API Key」页顶部，以及「子用户管理 · 设置」Tab。子用户只能跟着你的设置走。站点未开放该功能时，这两处入口都不显示。
- 开关关着时：「调用指南」菜单照常在，但页面里的分组标识调用名不再可用、带分组标识的调用会被拒；不影响用普通模型名正常调用。
- 开关开着时：可以去「调用指南」页复制「分组标识 / 模型名」这种完整写法（详见 子用户手册 · 调用指南）。
六、调用时走哪个分组（小结）
| 你调用时填的 model | 走哪个分组 |
|---|---|
普通模型名（如 deepseek-v4-flash） |
Key 未绑定分组直接拒绝；已绑定时优先走绑定分组，目标模型不在其中才查当前用户 / 主用户默认模型配置 |
带分组标识（如 A2C4E6G8/deepseek-v4-flash） |
开关开启时，固定走分组标识对应的分组；开关没开则被拒 |
选定分组不可用时，平台会返回错误，不会自动切换或降级。
七、常见问题
Q：建 Key 一定要选分组吗？ A：要。建的时候必须选一个，不选提交不了。这样用模型名调用才知道走哪个分组。
Q：老 Key 还能用吗？ A：能。老 Key 继续按它原来绑的分组工作，老脚本不用改。
Q：一把 Key 能走多个分组吗？ A：普通模型名调用只走它绑的那一个分组。想灵活切分组，得开「分组标识路由」后用带分组标识的写法。如果是订阅型 Key，还需要额外开启「订阅跨组调用」，详见 订阅管理与成员分配。
Q：子用户能自己建 Key 吗？ A：能。他在「API Key」页自助建，分组限于你授权给他的范围。
Q：调用时 model 该填什么？
A：填模型名即可（如 deepseek-v4-flash），可在「模型广场」或「默认模型配置」页复制准确的模型名。「模型广场」不在左侧菜单里，入口在顶部导航栏，受平台开关控制，小屏下会隐藏。
Q：Key 丢了或怀疑泄漏怎么办？ A：在「API Key」页找到它，先禁用或直接删，再建一把新的。禁用 / 删除后立即失效、无法恢复。