创建与保护 API Key - NexusAPI 文档中心

API Key 是调用 NexusAPI 接口的身份凭证。

创建流程

登录 NexusAPI 控制台。
进入令牌管理或 API Key 管理页面。
点击添加令牌。
填写令牌名称。
选择可用分组。
按项目预算设置额度或限制。
提交后复制生成的 API Key。

推荐设置

设置项	建议
名称	使用项目或客户端名称，例如 `codex-work`
分组	选择包含目标模型的分组
额度	按用途设置合理上限，后续可以调整
模型限制	只有明确需要时再启用
IP 白名单	服务器有固定出口 IP 时再启用
有效期	临时测试 Key 建议设置到期时间

使用方式

请求时将 API Key 放入 Authorization 请求头：

Authorization: Bearer YOUR_API_KEY

安全建议

不要把 API Key 写入公开代码仓库。
不要在截图、工单或聊天记录中发送完整 API Key。
不同项目、成员和环境建议使用不同 API Key。
生产环境通过环境变量或密钥管理服务读取，不要直接写在代码中。
定期检查使用日志；发现陌生来源或异常消费时，立即禁用旧 Key。
如果怀疑泄露，请先禁用或删除旧 Key，再创建新 Key，并更新使用它的程序。

API Key 与其他凭证

凭证	用途
API Key	调用模型接口，例如 Chat Completions、Responses、Messages、Images 和 `/v1/models`
系统访问令牌	查询自己账号的用量日志 API，在“个人设置 → 生成令牌”获取；不能调用模型
控制台登录状态 / Cookie	仅用于浏览器登录，不能用于 API 调用

系统访问令牌可读取账号级用量明细，应与 API Key 一样妥善保管。不要将任何凭证放在 URL 查询参数中，也不要把完整凭证发送给客服。