API Key 与分组

分组决定 Key 能调用的上游平台、模型范围、计费倍率和限额。创建 Key 时请按使用场景选择正确的分组。

创建与管理

选择分组 —— 想用 Claude Code 就选 Claude 平台的分组，想用 Codex 就选 OpenAI 平台的分组。模型不可用时，先检查 Key 的分组是否匹配。
设置限制 —— 可以为每个 Key 配置总额度、过期时间和速率限制，团队使用时建议按项目或成员拆分 Key，减少误用风险。
妥善保存 —— Key 创建后请立即复制保存；在文档或截图中分享时，只展示前后几位。

认证方式

两种认证方式等价，任选其一：

http

Authorization: Bearer YOUR_API_KEY
# 或
x-api-key: YOUR_API_KEY

未分配分组

如果请求返回类似 API key is not assigned to any group 的错误，说明这个 Key 还没有绑定分组，或分组已被删除。请在控制台重新创建 Key，或联系管理员分配分组后再测试。

团队使用建议

按项目、成员或环境拆分 Key，为每个 Key 配置独立额度与过期时间；
Key 保存在环境变量或密钥管理服务中，不要写死在代码里，更不要暴露到浏览器端；
出现异常消耗时，先通过用量记录定位是哪个 Key、哪个模型，再决定是否重置 Key。