认证与 API Key
创建、使用、限制、更换和保管 API Key。
创建 API Key
- 登录后打开控制台「API Keys」页面,给 Key 起一个能认出用途的名字。
- 按需要设置限制(每分钟请求数、预算、白名单),也可以以后再改。
- 创建后,Key 出现在列表里,点「复制」拿到完整的 Key(以
sk-开头),保存到安全的地方,例如服务器的环境变量。
在请求里带上 Key
OpenAI 兼容接口用 Authorization: Bearer 请求头;Anthropic 接口用 x-api-key,也接受 Authorization: Bearer。建议把 Key 放在环境变量里,不要写进代码。
Authorization: Bearer YOUR_API_KEY
给 Key 加限制
每把 Key 都可以单独设置下面这些限制,互不影响:
| 设置 | 作用 |
|---|---|
| 每分钟请求数 | 这把 Key 每分钟最多发多少个请求。 |
| 每日预算 | 这把 Key 每天(UTC)最多花多少美元。 |
| 总额度 | 这把 Key 一共最多花多少美元,适合交给自动化任务、防止跑飞。 |
| 模型白名单 | 这把 Key 只能调用列出的模型。 |
| IP 白名单 | 只接受来自列出的 IP 或网段的请求。 |
停用与更换
- 先新建一把 Key,把用到的地方换成新的。
- 确认新 Key 在正常调用后,在控制台停用旧 Key;停用立即生效,之后旧 Key 的请求返回 401。
- 怀疑 Key 泄露时,先停用,再新建。
安全建议
- Key 只放在服务端;不要写进网页、App 或公开的代码仓库。
- 每个应用、每个环境用一把单独的 Key,出问题时只停那一把。
- 给自动化任务和第三方工具用的 Key 设上预算或总额度。
- 服务器 IP 固定时,打开 IP 白名单。
余额属于账户
同一个账户下的所有 Key 共用一个余额。用任意一把 Key 调用 GET /v1/usage 都能查到账户余额和消费。