密钥管理

最后更新 2026-11-11

API 密钥决定谁可以调用、能调用哪些模型、最多花多少钱。每个账号最多同时有 50 把有效密钥（已撤销和已过期的不算），建议按应用或环境分开使用，出问题时只停用其中一把。

完整密钥只显示一次

• 完整密钥以 mp- 开头（早期创建的以 key_ 开头，照常可用），只在创建成功的弹窗里显示一次，请当场复制保存。
• 弹窗关闭后，密钥页和接口都只显示末 4 位，平台只保存密钥的哈希，管理员也拿不到完整密钥。
• 遗失了就撤销这把，再新建一把。

暂停与撤销

暂停或过期的密钥返回 key_inactive，撤销和写错的密钥返回 invalid_api_key，都是 HTTP 401。密钥只在请求开始时校验，已经在进行中的调用会正常完成并计费。

给密钥加限制

创建或编辑密钥时，可以为每把密钥单独设置：

• 可用模型：只允许调用列出的模型，留空表示全部模型。调用列表外的模型返回 key_restricted（HTTP 403）。
• 每日 / 每月消费上限：按实例币种设置。平台在调用前按预估费用判断，单次调用可能让实际花费略超上限，之后的调用会被拒绝，返回 budget_exceeded（HTTP 402）。日与月按 UTC 切换，北京时间每天 8 点进入新的一天。
• IP 白名单：填写单个 IP 或 CIDR 网段，名单外的来源返回 key_restricted（HTTP 403）。
• 过期时间：到期后自动失效。

安全建议

• 密钥只放在服务端环境变量或密钥管理系统里，不要写进前端代码、移动端安装包或公开仓库。
• 请求时只放在请求头（Authorization: Bearer 或 Anthropic 的 x-api-key），URL 参数里的密钥一律拒绝。
• 怀疑泄露时先撤销，再新建一把，然后检查用量里对应密钥的调用记录。