创建 API Key
API Key 是调用 RouterBus 的凭证。所有 CLI 工具和 SDK 都用它来认证。
创建步骤
- 登录控制台,进入 API 密钥 页面(/keys)
- 点击新建
- 填写名称,方便日后区分用途
- 按需设置可选项:
| 选项 | 说明 |
|---|---|
| 分组 | 默认自动选择最优分组,也可以固定到某个分组 |
| 可用模型 | 限制这把 Key 能调用的模型;留空表示不限制 |
| 额度 | 这把 Key 最多能消费多少;可设为不限 |
| 过期时间 | 到期后自动失效 |
| IP 限制 | 只允许指定 IP 使用这把 Key |
- 提交
拿到 Key
创建后在列表里对这把 Key 使用 复制密钥,随时可以再复制一次,不必担心创建时没保存下来。
Key 的格式是:
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx请像密码一样保管
任何拿到这串字符的人都能花你的余额。不要提交到代码仓库、不要贴进聊天群和工单。一旦泄露,立刻在 API 密钥 页面删除这把 Key,再建一把新的。
使用方式
在请求头中携带:
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx或配置成 CLI 工具的环境变量,详见 配置 CLI 工具。
列表里的其他操作
- 复制连接信息 —— 一次性复制地址与 Key,方便粘贴到客户端
- CC Switch —— 一键把这把 Key 导入 CC-Switch,见 CC-Switch 配置教程
- 聊天 —— 用这把 Key 打开内置聊天界面
- 启用 / 禁用 —— 临时停用而不删除
- 删除 —— 立即失效,不可恢复
建议
按用途分开建 Key(比如 Claude Code 一把、脚本一把),用量日志里就能按 Key 区分开,停用某个用途也不会影响其他。