创建 API 密钥
API 密钥（API Key）是调用 Bita API 的身份凭证。无论使用代码、SDK 还是第三方工具，都需要填写 API 密钥才能访问模型。
建议为不同的应用、设备或项目分别创建 API 密钥。这样可以单独设置有效期和额度，也便于查看用量或停用某个接入。
打开创建页面
- 登录 Bita API 用户控制台。
- 进入「API 密钥」页面。
- 点击「创建 API 密钥」，打开创建抽屉。
填写基本信息
名称
填写一个便于识别用途的名称，例如：
Cherry StudioClaude Code个人项目临时测试
名称仅用于你在控制台中区分不同密钥，不需要填写模型名称。
分组
分组决定这枚 API 密钥使用哪一组模型渠道和计费规则，是创建密钥时最重要的配置之一。不同分组可能有不同的可用模型、请求路由和计费倍率。
分组会影响什么
- 可用模型：某些模型可能只在指定分组中开放。选择分组后，API 密钥只能使用该分组能够访问的模型。
- 请求路由：系统会在该分组对应的渠道中处理请求。不同分组可能对应不同的模型来源或服务线路。
- 计费倍率：分组名称右侧会显示倍率，例如
1x、0.7x或0.6x。倍率会参与计算这枚密钥的实际消耗。
如何阅读分组选项
每个分组选项通常包含三部分：
| 显示内容 | 示例 | 说明 |
|---|---|---|
| 分组名称 | claude-origin | 创建 API 密钥时实际选择的分组标识 |
| 分组说明 | claude | 帮助识别分组用途 |
| 计费倍率 | 0.7x | 该分组参与最终计费的倍率 |
当前页面展示了以下分组：
| 分组 | 说明 | 分组倍率 |
|---|---|---|
claude-origin | claude | 0.7x |
default | 用户分组 | 1x |
gpt-origin | gpt | 0.6x |
分组列表和倍率可能随站点配置调整，请始终以创建页面当时显示的信息为准。
分组倍率如何影响消耗
只考虑分组倍率时，可以使用下面的简化公式理解：
实际消耗 = 模型基础消耗 × 分组倍率
假设某次请求的模型基础消耗为 100：
| 分组倍率 | 计算 | 该次实际消耗 |
|---|---|---|
1x | 100 × 1 | 100 |
0.7x | 100 × 0.7 | 70 |
0.6x | 100 × 0.6 | 60 |
实际账单还会受到模型输入价格、输出价格、请求 Token 数量以及模型自身计费方式影响。倍率较低不代表所有模型都更便宜，也不代表该分组支持全部模型。
应该选择哪个分组
建议按以下顺序选择：
- 先确认模型是否可用：确定准备调用的模型在该分组中可用。
- 遵循接入文档要求：如果某个第三方工具或模型的接入文档指定了分组，优先使用指定分组。
- 再比较倍率：在模型和接口均满足需求的前提下，再比较不同分组的倍率。
- 不确定时选择
default：先使用默认分组完成首次调用，再根据实际模型需求创建其他分组的密钥。
建议为不同工具和分组分别创建 API 密钥，例如为 Claude Code 创建一枚密钥、为 Codex 创建另一枚密钥。这样更容易区分调用记录、核对消耗和单独停用密钥。
如果分组选择不正确，可能出现模型列表中找不到目标模型、调用时提示模型不可用，或实际计费倍率与预期不同。遇到这类问题时，应先核对 API 密钥的分组和目标模型。
过期时间
设置 API 密钥的有效期限。页面提供「永不」「1 个月」「1 天」「1 小时」等快捷选项，也可以选择具体日期和时间。
- 长期使用的个人客户端，可以选择较长的有效期。
- 临时测试或临时共享环境，建议设置较短的有效期。
- 选择「永不过期」后，密钥会持续有效，直到你主动停用或删除它。
API 密钥到期后将无法继续调用接口，需要延长有效期或创建新的密钥。
数量
填写本次需要创建的 API 密钥数量，默认为 1。
数量大于 1 时，系统会一次创建多个密钥，并在名称后添加随机后缀。只有需要为多个应用或成员分别生成密钥时才建议批量创建。
设置额度
无限额度
开启「无限额度」后，该 API 密钥本身不设置单独的消耗上限，但调用仍然受账户余额和站点规则限制。
关闭「无限额度」后，可以为这个 API 密钥设置独立额度。额度耗尽后，该密钥将无法继续调用接口，但不会影响账户下的其他密钥。
个人长期使用可以保留无限额度；测试、临时工具或需要控制成本的项目，建议关闭无限额度并设置合理上限。
创建并保存密钥
- 确认名称、分组、过期时间、数量和额度设置。
- 点击右下角的「保存更改」。
- 创建成功后，立即复制生成的完整 API 密钥并妥善保存。
创建成功后应立即复制并保存 API 密钥。API 密钥列表默认显示脱敏内容，可以通过页面提供的「查看」或复制按钮按需获取密钥。
查看完整密钥时，请确认周围环境安全。不要将 API 密钥发送给他人，也不要提交到 Git、公开代码仓库或前端网页中。如果怀疑密钥已经泄露，请立即停用或删除该密钥，并创建新密钥。
下一步
API 密钥创建完成后，继续阅读选择模型。