管理 API 密钥

API 密钥页面集中展示当前账户创建的所有密钥。你可以在这里核对密钥状态、额度、分组和模型限制，并对单个密钥执行管理操作。

打开 API 密钥页面

1. 登录 Bita API 并进入控制台。
2. 在左侧导航栏中点击「API 密钥」。

查看密钥列表

列表中的每一行代表一枚 API 密钥：

列	说明
名称	创建密钥时填写的用途名称
状态	显示密钥当前是否已启用
API 密钥	默认以脱敏形式显示，并提供复制按钮
额度	显示密钥的用量与额度进度
分组	显示密钥所属分组及分组倍率
模型	显示该密钥的模型限制；「无限制」表示没有单独设置模型范围
操作	停用或启用、编辑以及更多管理操作

密钥额度和账户余额是两套限制。密钥显示还有额度，不代表账户余额一定充足；密钥开启无限额度，也不代表账户余额不会被扣减。

筛选 API 密钥

密钥较多时，可以使用列表上方的筛选功能：

• 按名称筛选：输入创建密钥时填写的名称。
• 按 API 密钥筛选：输入密钥的可识别部分查找对应记录。
• 状态筛选：只查看已启用或已停用的密钥。

建议使用能够反映用途的名称，例如 Cherry Studio、Claude Code 或具体项目名称，避免创建大量无法区分的 test 密钥。

查看和复制密钥

API 密钥在列表中默认以脱敏形式显示，避免他人直接从屏幕读取完整内容。

• 点击密钥旁边的复制按钮，可以将密钥复制到剪贴板。
• 点击页面右上方的「查看」，可以按页面提示查看密钥内容。
• 使用完成后，不要让完整密钥长时间停留在聊天窗口、文本文档或剪贴板工具中。

查看密钥前先确认环境

共享屏幕、录制视频或截屏时，不要显示完整 API 密钥。文档截图和问题反馈中应始终使用脱敏密钥。

启用和停用密钥

操作列中的状态按钮可以切换 API 密钥的启用状态。

适合临时停用的情况

• 暂时不再使用某个工具或项目
• 怀疑密钥可能泄露，需要立即阻止调用
• 排查异常余额消耗
• 在切换分组或客户端配置前暂停请求

停用后，使用该密钥的客户端和代码将无法继续调用 API。重新启用后，原密钥可以继续使用，但仍需满足有效期、额度和账户余额要求。

编辑密钥

点击操作列中的编辑按钮，可以打开密钥编辑页面。根据当前页面提供的字段，可以调整名称、分组、过期时间或额度等设置。

编辑前应考虑这些影响：

• 修改名称只影响控制台中的识别方式。
• 修改分组可能改变可用模型、请求路由和计费倍率。
• 缩短有效期可能使正在使用的客户端提前失效。
• 降低额度可能导致密钥立即达到限制。

修改分组后，应重新查询 /v1/models 并测试目标模型，确认客户端仍能正常调用。

更多操作

点击操作列中的「…」可以打开更多操作菜单。具体选项以页面实际显示为准。

如果菜单中提供删除操作，删除前应确认该密钥已经从所有客户端、服务器和自动化任务中移除。删除后的密钥不能恢复。

先停用，再删除

不确定某枚密钥是否仍在使用时，可以先停用并观察一段时间。确认没有业务受到影响后再删除。

密钥泄露后的处理

如果 API 密钥被提交到公开仓库、发送到不可信渠道，或出现无法解释的调用记录，应立即轮换密钥：

1. 在 API 密钥列表中停用疑似泄露的密钥。
2. 创建一枚用途、分组和额度配置正确的新密钥。
3. 将客户端、服务器或环境变量更新为新密钥。
4. 使用新密钥完成一次模型列表查询和对话请求。
5. 确认业务恢复后删除旧密钥。
6. 检查使用日志和余额，确认是否存在异常消耗。

仅修改客户端中的密钥名称不能解决泄露问题，必须停止使用旧的密钥值。

管理建议

• 一个工具或项目使用一枚独立密钥。
• 使用清晰名称标识密钥用途。
• 临时用途设置过期时间和额度上限。
• 定期清理不再使用的密钥。
• 发现异常调用时先停用密钥，再排查日志。
• 更换分组后重新测试模型可用性和计费倍率。

下一步

需要进一步控制单枚密钥的分组、额度和可用范围时，继续阅读API Key 权限与额度限制。