创建 API Key

API Key 用于让客户端或 SDK 访问 SupaRouter。请只在你信任的本机、服务器或工具中保存它。

创建前确认

• 账号已登录。
• 账号有可用额度。
• 已大致确认要使用的分组和模型。

创建后你会用到

• Base URL：https://api.suparouter.xyz/v1
• API Key：控制台创建后复制保存。
• Model：使用模型价格页或创建 API Key 页面展示的模型名。
• 分组：决定可用模型范围、路由策略和计费档位。

页面操作步骤

1. 登录 SupaRouter 控制台。
2. 进入侧边栏的「令牌管理」，或直接打开 https://suparouter.xyz/console/token。
3. 点击「添加令牌」。
4. 在「基本信息」里填写令牌名称，例如 codex-main、chatbox-test 或你的项目名。
5. 在「令牌分组」里选择要使用的分组。可选项来自当前账号可用分组；如果没有可选项，表示当前账号暂时没有可自主选择的分组。
6. 如果选择 auto 分组，按需决定是否开启「跨分组重试」。开启后，当前分组渠道失败时会按顺序尝试下一个分组的渠道。
7. 设置过期时间。长期自用可以选择「永不过期」，临时测试建议设置较短时间。
8. 在「额度设置」里决定是否开启「无限额度」。这里限制的是该令牌本身最多可使用多少额度，实际调用仍受账号余额限制。
9. 如无特殊需求，「访问限制」里的模型限制列表和 IP 白名单可以先留空。
10. 点击「提交」创建令牌。
11. 回到令牌列表后，点击复制令牌，并立即保存到你的客户端或本机凭据文件中。

创建成功后的完整 API Key 只在复制时使用。不要把它发送到公开群、截图或仓库中。

安全提醒

• 不要把 API Key 提交到 Git 仓库。
• 不要把包含 API Key 的截图发到公开渠道。
• 如果怀疑 API Key 泄露，请尽快删除并重新创建。

创建完成后，可以继续看第一次接入或选择你的接入方式。