API Key 管理

API Key 是调用 NexusKey 网关的唯一凭证（形如 sk-…）。

创建 Key

1. 控制台「API 密钥」页 → 「创建」；
2. 填写名称（建议按用途/环境命名，如 prod-claude-code）；
3. 创建成功后立即复制保存：密钥明文仅展示一次；
4. 在密钥列表「分组」列为 Key 分配分组——未分配分组的 Key 调用返回 403。

使用配置

点击 Key 行的「使用配置」，弹窗按平台给出可直接复制的环境变量/配置文件片段（Claude Code、Codex、OpenAI SDK 等），并附 快速开始 文档入口。

生命周期操作

操作	效果
重置	生成新密钥明文，旧 Key 立即失效；用于轮换或泄露应急
启用/禁用	禁用后调用返回 401，配置保留
删除	不可恢复；用量历史保留在「使用记录」
编辑	改名、调整配额/速率限制（若站点开放）

配额与速率

Key 可配置总额度（quota）与速率限制（RPM/TPM 等）：

• 配置了额度/速率的 Key，GET /v1/usage 返回 quota 视图（剩余量、重置时间）；
• 未配置的 Key 返回无限制视图（仅受账户余额与分组速率约束）；
• 触发 Key 级限制返回 429 并带 Retry-After，见 速率与配额。

安全实践

• 一环境一 Key：开发/测试/生产分离，便于对账与熔断；
• 只存服务端：勿写入前端代码、公开仓库或日志；
• 定期轮换：高价值生产 Key 建议季度轮换（重置后更新部署 secret）；
• 泄露应急：立即重置 → 检查「使用记录」异常调用 → 联系支持冻结争议消费。