API Keys 与智能路由

API Key 用于验证模型请求。个人 Key 消耗个人额度；组织 Key 消耗组织额度，并归属到对应成员。

创建 API Key

1. 确认顶部工作区正确。
2. 打开“API Keys”。
3. 点击“创建 Key”。
4. 填写用途明确的名称，例如 codex-work。
5. 选择路由方式。
6. 点击创建。

新创建的完整 Key 会加密保存，之后仍可在“API Keys”页面复制，不必只在创建弹窗中保存。

选择路由方式

智能路由（默认）

智能路由会：

• 自动匹配支持当前模型的可用渠道分组。
• 当前渠道异常时切换到其他可用渠道。
• 让一个 Key 使用多个渠道分组中提供的模型。

大多数用户应保持智能路由。

指定渠道分组

指定渠道分组会把 Key 固定到选中的分组，不自动切换。适合需要固定价格、来源或线路的场景。

固定分组后，Key 只能调用该分组中存在的模型。

高级选项

创建或编辑 Key 时可以设置：

• 过期时间：到期后 Key 自动停止接受请求。
• RPM 限制：每分钟请求数；0 表示不额外限制。
• TPM 限制：每分钟 Tokens；0 表示不额外限制。
• 可用模型：限制该 Key 只能调用选中的模型。
• 用途说明：记录 Key 对应的工具或环境。

复制、轮换与停用

• 点击复制按钮可复制系统保存的完整 Key。
• 较早创建的 Key 如果显示“需轮换”，先执行“轮换密钥”，再复制或同步到客户端。
• 轮换后旧 Key 会立即失效，使用旧 Key 的工具必须更新。
• 暂时不用的 Key 可以停用；确认不再需要后再删除。

页面支持按名称、前缀、成员或渠道分组搜索，并可按状态和渠道分组筛选。

使用 Better Gate 客户端

1. 打开客户端并登录。
2. 完成浏览器授权。
3. 选择工作区、工具和 API Key。
4. 应用配置并重启对应工具。

创建或轮换 Key 后，在客户端中刷新即可同步。

手动接入

基础地址：

https://gateway.better-gate.com

OpenAI 兼容地址：

https://gateway.better-gate.com/v1

API Key 填 Better Gate 中复制的完整 Key，模型 ID 从“模型列表”复制。

通过 cURL、Python、Node.js 或原生厂商协议调用时，请查看 API 接入。

安全建议

1. 不要把 Key 写进浏览器前端代码。
2. 不要把 Key 提交到代码仓库或发给无关人员。
3. 不同项目和环境使用不同 Key。
4. 通过过期时间、模型范围、RPM 和 TPM 缩小权限。
5. 发现异常后先停用或轮换，再到“用量日志”检查请求。