准备工作：账号、密钥、分组、充值
本页中的
{baseUrl}是平台 API 根地址（不含末尾/或/v1），使用前请替换为实际地址。模型、价格和界面以当前控制台及客户端版本为准。
注册与登录
- 打开 首页，点击右上角「登录 / 注册」
- 支持邮箱注册；平台同时开放了 GitHub / Google / Microsoft / LinuxDO / 微信等第三方登录入口
- 登录后进入 控制台
创建 API Key（令牌）
路径：控制台 → 左侧「令牌」→ 右上角「添加令牌」
需要填写的字段：
| 字段 | 填写建议 |
|---|---|
| 名称 | 按用途命名，如 cherry-studio、claude-code、codex，便于分账和管理 |
| 额度 | 留空 = 不限额度（受账户总余额约束）；也可设单令牌上限做成本隔离 |
| 过期时间 | 留空 = 永不过期；建议生产环境设 90 天 |
| 分组 | 最容易配错的一项，分组决定了能用哪些模型。控制台令牌页下拉框里能选到的，就是你账号可用的分组。 |
| 模型限制 | 留空 = 可用全部模型；可勾选白名单限制该令牌能调用的模型 |
建议按工具建独立令牌。原因有三：一是能按工具看用量；二是某个工具泄露时可单独吊销而不影响其他工具；三是 Claude Code / Codex 这类工具需要单独分组。
平台支持「自动分组」 ：令牌分组留空时，系统会按模型自动匹配可用分组，这是最省心的做法，但不利于成本追踪。
注意区分两种令牌 ：调用模型用
sk-开头的模型密钥；调用/api/...管理接口用登录后生成的访问令牌（access_token），两者不通用。
充值
控制台 → 「钱包 / 充值」，支持在线充值与兑换码两种方式。计费方式为按量付费，用多少扣多少。