账户
API 密钥管理
创建用于客户端和程序调用的专用密钥。
创建密钥
进入 API 密钥，选择创建 API 密钥。为不同工具分别创建密钥，便于限制额度和停用。
| 字段 | 如何填写 |
|---|---|
| 名称 | 使用可辨识名称，例如 cherry-desktop |
| 分组 | 选择账户可用且包含目标模型的分组；不了解时保留表单默认选择 |
| 有效期 | 临时测试使用较短期限，长期使用按需要设置 |
| 创建数量 | 首次接入创建 1 个即可 |
| 额度 | 按界面显示的货币或额度单位设置调用上限 |
| 无限额度 | 仅取消该密钥的额度上限，不表示免费或账户余额无限 |
| 模型限制 | 开启后仅允许选中的型号；需包含准备使用的模型 |
保存后复制密钥，在工具的 API Key 字段填写。HTTP 请求则使用 Authorization: Bearer 请求头。
一键生成工具配置
在密钥右侧的操作菜单中选择 接入配置，选好工具和模型后，页面会生成已经填好密钥、地址和模型 ID 的配置，复制即可使用：
| 工具 | 生成内容 |
|---|---|
| Claude Code | ~/.claude/settings.json |
| Codex | ~/.codex/config.toml |
| OpenCode | ~/.config/opencode/opencode.json |
| WorkBuddy / CodeBuddy | 添加自定义模型时要填的接口地址、API Key、模型 ID |
| Python / cURL | 可以直接运行的请求示例 |
注意
生成的配置包含完整密钥，不要截图外发或提交到代码仓库。
不能调用时检查什么
依次确认密钥是否启用、是否到期、是否有剩余额度、是否允许目标模型，以及账户余额是否充足。密钥额度和账户余额是两项不同限制。
编辑与停用
从密钥列表进入对应操作修改配置。无需使用的密钥及时停用；泄露的密钥应撤销并重新创建，然后更新使用它的工具。
使用范围
此处创建的密钥用于模型 API，不是账户登录密码，也不是上游厂商的密钥。不要共享截图中的完整密钥。