外观
API 密钥(令牌)
API 密钥(也叫令牌)用来在调用接口时证明你的身份,并从你的账户余额扣费。在控制台 API 密钥 页面管理。
创建密钥
点击 创建 API 密钥,可以设置:
| 设置项 | 说明 |
|---|---|
| 名称 | 方便自己区分用途,例如 claude-code、生产环境 |
| 过期时间 | 永不过期,或 1 小时 / 1 天 / 1 个月 / 自定义时间后失效 |
| 数量 | 一次批量创建多个密钥 |
| 额度 | 这个密钥最多能花多少;勾选 无限额度 则只受账户余额限制 |
| 分组 | 使用哪个计费分组,不同分组价格可能不同 |
| 模型限制 | 只允许这个密钥调用指定的模型 |
| IP 白名单 | 只允许指定 IP 或网段(支持 CIDR,如 203.0.113.0/24)使用 |
使用建议
- 一个用途一个密钥:不同工具、不同项目分别建密钥,出问题时只需作废一个。
- 给共享或测试用的密钥设额度:避免意外刷爆余额。
- 服务器上用 IP 白名单:即使密钥泄露,别人也无法使用。
- 泄露后立即删除或禁用:在列表中操作,立刻生效。
在请求中使用
任选一种方式携带密钥:
| 接口类型 | 请求头 |
|---|---|
| OpenAI 兼容 | Authorization: Bearer sk-你的密钥 |
| Claude(Anthropic) | x-api-key: sk-你的密钥(也支持 Authorization: Bearer) |
| Gemini | x-goog-api-key: sk-你的密钥,或 URL 参数 ?key=sk-你的密钥 |