创建与管理 API Key
了解 API Key 的用途，完成创建和复制，再按需要设置额度、有效期与模型限制。
API Key 是工具或程序调用 Orbis 模型时使用的凭据。 把它填入客户端，客户端就能以你的账户发起调用，费用计入你的账户。
1. 先认识三个配置
| 配置 | 用来做什么 |
|---|---|
| API Key | 验证调用身份，并确定使用的线路与权限限制 |
| Base URL | 告诉工具把请求发送到哪里 |
| 模型 ID | 指定本次调用哪个模型 |
Key 只能调用所选线路支持且账户有权限使用的模型。只改模型 ID，不会自动切换线路。
2. 创建并复制 Key
- 打开控制台的 API 密钥，点击 创建 API 密钥。
- 填写容易识别的名称，例如
我的 Codex，选择要使用的 线路。 - 按需设置额度与有效期，点击 保存更改。
- 在这枚 Key 右侧的操作菜单中点击 复制密钥。
已经在模型页面选好了线路？也可以直接 快速创建 API Key。
3. 把 Key 填入工具
进入所选线路的接入页，按页面说明将 完整 Key、Base URL 和模型 ID 填入工具，再发送一条简短消息验证。
页面上带遮罩的 Key 不能直接使用，请用复制按钮获取完整内容。Codex、Claude Code、CC Switch 和 cURL 的具体操作见 5 分钟快速开始。
4. 需要时，再加限制
在 API 密钥 中找到目标 Key，打开操作菜单，点击 编辑。
| 设置 | 什么时候用 |
|---|---|
| 额度 | 为测试或某个项目设置可用额度；关闭「无限额度」后填写金额，单位以页面为准 |
| 有效期 | 临时测试、短期项目需要到期后停止使用 |
| 模型限制 | 只允许这枚 Key 调用指定模型；在高级设置中选择需要的模型 |
| IP 白名单 | 只允许指定 IP 或网段调用；适合有固定出口 IP 的服务器 |
无限额度不等于免费。 它只表示不单独限制这枚 Key，调用仍需账户有可用余额。给 Key 设置额度也不会给账户充值，多个 Key 共用账户余额。
模型限制只能缩小可用范围，不能让 Key 调用当前线路不支持的模型。不了解出口 IP 时，先留空 IP 白名单，避免把自己的请求拦住。
5. 日常管理与安全
建议每个工具或项目使用独立 Key，例如 日常 Codex、网站后端。这样可以分别调整限制，或单独停用。
- 暂时不用：停用 Key，需要时再启用；恢复使用前确认额度和有效期。
- 确定不再使用：删除 Key，依赖它的工具将无法继续用它调用。
- 怀疑泄露：立即停用旧 Key，创建新 Key，并更新工具配置；到 使用日志 检查异常调用。
不要把 Key 发到群聊、公开截图、网页前端代码或代码仓库。复制的连接信息、工具导入链接也可能包含 Key，同样需要保密。
修改 Key 的线路会影响所有使用这枚 Key 的工具。切换前确认目标线路支持正在使用的模型与接入方式；只想试另一条线路时，建议新建 Key。