在 Cherry Studio 中使用 BeatAPI

Cherry Studio 是一个可以并列接入多个服务商的桌面对话客户端。把 BeatAPI 添加为 OpenAI 类型的服务商之后，账户下所有文本模型都会出现在它的模型选择器里。

准备工作

1. 已安装 Cherry Studio —— 从官网下载。
2. 一把 BeatAPI 密钥 —— 在控制台 → API 密钥创建。

第一步：打开服务商设置

点右上角设置图标，或按 Ctrl+,（macOS 为 Cmd+,），然后在左侧菜单选择 模型服务。

第二步：添加 BeatAPI 服务商

在模型服务页面底部点 + 添加，填写：

点确定。然后在右侧配置区填写：

确认右上角 BeatAPI 服务商的开关是打开状态（绿色），再用检测按钮验证一下连通，然后再添加模型。

第三步：添加模型

服务商配好后，在模型区域点管理打开模型选择窗口，搜索编号后点 + 添加。

完整目录见文本 API 各页与价目页。想加多少加多少，聊天时在顶部下拉里随时切换。

第四步：开始对话

回到主界面，点 + 新建对话，在顶部点模型选择器，在 BeatAPI 服务商下选一个模型即可。

常见问题

Cherry Studio 连不上

1. API 地址必须是 https://api.beatapi.io —— 不带 /v1。
2. 密钥必须处于可用状态 —— 在控制台 → API 密钥确认。
3. 服务商开关必须是打开的。

模型列表为空或刷新不出来

在模型管理里按编号手工添加。编号见价目页，区分大小写。

对话过程中报错

查看用量与消费

控制台按密钥展示调用次数、token 与费用，同样的数据也可从 GET /v1/usage 获取。

获取支持

在控制台提交工单，并附上失败响应里的 request_id。