第 2/7 节课 · 8 分钟

团队的 API 密钥

为每个应用和环境提供单独的受限密钥,用管理密钥实现自动化,并在不停机的情况下轮换密钥。

所有者和管理员在 设置 → API 密钥 中创建 API 密钥。每个应用和环境使用一个密钥,而不是所有人共用一个。这样你就能查看每个密钥的用量、限制它,并在不影响其他任何东西的情况下替换它。密钥只显示一次,所以要直接把它存进你的密钥管理工具。

每个密钥都可以设置每日、每周或每月的请求数和支出限制。每个请求都会检查这些限制,并分别在 UTC 午夜、周一或每月 1 日重置。达到限制后,使用该密钥的请求会被拒绝,直到窗口重置。密钥安全 会列出一旦泄露可能造成损害的密钥:没有支出限制、没有到期时间、闲置 90 天或以上,或可以从任意 IP 地址使用。

对于自动化任务,例如创建密钥或读取用量的脚本,请使用 设置 → 管理密钥 中的 管理密钥。管理密钥不能发送模型请求。选择一个模板:读取、写入(不含删除)或 全部,或者只选择你需要的权限。管理密钥能做的事情永远不会超过其背后那个人的角色所允许的范围。

要替换密钥,选择 轮换。Phaseo 会创建一个具有相同限制的替代密钥,并让你选择当前密钥何时过期:立即、1 小时后、24 小时后或 7 天后、你指定的时间,或永不过期。在旧密钥过期之前,把你的应用切换到新密钥。你也可以暂停一个密钥并在之后恢复,或者永久删除它。已吊销的密钥无法重新启用。

检验你的理解

你的团队想要一个每晚运行、用于创建和删除 API 密钥的脚本。它应该使用哪种凭据?

学以致用

一位开发者告诉你,生产环境的 API 密钥在一小时前被推送到了一个公开代码仓库。你该怎么做?

显示答案

立即轮换该密钥,并选择让当前密钥立即过期。把新密钥放进你的密钥管理工具,并更新应用。然后在 设置 → 日志 中检查该密钥的请求,看是否有你不认识的请求。先轮换,再调查。

要点

每个应用和环境一个密钥,并为每个密钥设置支出限制,这样泄露的影响很小,轮换也很轻松。

相关链接

进度保存在此浏览器中。

最后核对于 2026年11月17日