API 密钥管理

一把密钥，对应一个用途#

在API 密钥页面新建密钥。建议按设备或应用命名，例如 work-codex、server-chat，而不是多人共用一把。这样停用某个应用时，其他应用还能继续工作。

• 服务分组决定这把密钥可以使用的渠道和模型。
• 额度与有效期控制密钥的使用边界；以创建页面实际提供的选项为准。
• 如使用 IP 限制，先确认应用的实际出口 IP，尤其是代理、公司网络与动态家庭宽带。

密钥与登录密码有什么区别#

安全保存与轮换#

1. 在服务端环境变量、受控密钥管理工具或本机配置中保存密钥。
2. 不要写进前端网页、公开仓库、示例文件或报错截图。
3. 需要更换时，先创建新密钥，更新应用并验证，再停用旧密钥。
4. 怀疑泄露时立即停用受影响密钥，并检查使用记录中的异常请求。

如果源码曾经提交过密钥，删掉当前文件里的文字不等于从 Git 历史清除；应先让旧密钥失效。