本页目录
一把 Key 管一件事
把 Key 当成「可独立吊销的用途单元」，而不是账户密码。推荐的粒度是环境 × 业务：
text
web-prod 线上网页应用
web-staging 预发环境
batch-etl 夜间批处理任务
partner-acme 给合作方的临时 Key（设过期时间）
local-alice 开发者本地好处是：出问题时只吊销一把；用量报表天然按业务拆分；给外部人员的 Key 可以单独限定模型与有效期。
每把 Key 可配置什么
| 配置 | 作用 | 典型值 |
|---|---|---|
| 可用模型 | 限制可调用范围 | 批处理只允许小模型 |
| 折扣与线路 | 按哪一档价格计费 | 默认跟随账号设置 |
| 归属项目 | 按项目拆分用量 | 每个业务一个项目 |
| 有效期 | 到期自动失效 | 外部合作方 30 天 |
| 状态 | 启用 / 禁用 | 临时停用优先用禁用 |
轮换流程
- 创建新 Key，命名带上日期（
web-prod-2026q3）。 - 更新密钥管理服务里的值，滚动重启服务。
- 在用量页面确认新 Key 的调用量已经接管、旧 Key 归零。
- 先禁用旧 Key 观察 24 小时，确认无遗漏后再删除。
注意
删除不可恢复，且立即生效。如果还有定时任务、离线脚本或第三方集成在用这把 Key，删除后会直接 401。先禁用再删除能把这个风险降到最低。
团队协作
- 不要在群里传 Key。共享的是访问密钥管理服务的权限，不是 Key 本身。
- 成员离职时吊销其名下的所有 Key（
local-*），不必动线上 Key。 - 把 Key 名称写进服务的启动日志（只记名称，不记值），排查时能立刻知道用的是哪把。
相关
- 获取 API Key：创建流程与保管建议。
- 用量统计：按 Key 查看消费。
联系我们
文档没写清楚，或者需要人工协助？按问题类型选一个渠道即可。