API 密钥管理
创建、复制和管理 API 密钥,以及额度、过期时间、模型限制等选项的含义。
更新于 2026-11-15
API 密钥是调用接口的凭证。建议为每个项目或每台设备单独创建密钥,便于分别统计用量,也便于在泄露时单独停用。
创建密钥
进入控制台「API 密钥」页面,点击「创建 API 密钥」,按需填写以下选项:
| 选项 | 说明 |
|---|---|
| 名称 | 便于自己识别的名字,例如项目名。 |
| 分组 | 密钥调用模型时使用的分组。不同分组的价格倍率可能不同。 |
| 过期时间 | 可选永不过期,或设置一个到期时间。过期后密钥无法使用。 |
| 数量 | 一次性批量创建多个相同设置的密钥。 |
| 额度 | 这个密钥最多能消耗的额度。也可以开启「无限配额」,此时只受账户余额限制。 |
| 模型限制 | 在「高级设置」中,限制该密钥只能调用指定的模型。 |
| IP 白名单 | 在「高级设置」中,只允许来自指定 IP(支持 CIDR)的请求使用该密钥。 |
复制与导入
在密钥所在行的操作菜单中:
- 复制密钥:复制以
sk-开头的密钥。 - CC Switch:一键导入到 CC Switch,见「CC Switch 一键导入」。
- 聊天:一键导入到 Cherry Studio 等客户端,见「Cherry Studio 接入」。
- 禁用 / 启用:临时停用密钥,之后可以重新启用。
- 删除:永久删除密钥。
安全建议
- 不要把密钥写进前端代码、提交到公开仓库,或发在群聊里。
- 为密钥设置额度上限,避免意外消耗过多余额。
- 怀疑密钥泄露时,立即在「API 密钥」页面禁用或删除它,再创建新的密钥。