在 Cherry Studio 中使用 BeatAPI

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

准备工作

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

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

字段	值
服务商名称	`BeatAPI`
服务商类型	`OpenAI`

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

字段	值
API 密钥	你的 BeatAPI 密钥
API 地址	`https://api.beatapi.io`

这里填 https://api.beatapi.io，不要带 /v1，后面也不加任何路径。Cherry Studio 会自己拼上 /v1/chat/completions；你再加一个 /v1 就变成了 /v1/v1/chat/completions，每条消息都会 404。

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

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

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

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

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

状态码	含义	处理
`401`	`missing_api_key` 或 `invalid_api_key`：密钥缺失、错误、已过期、已停用或额度已用尽	从控制台重新复制密钥
`402`	`insufficient_credits`：余额为零或低于本次价格	充值
`404`	模型编号或 API 地址填错了	对照上面两条说明检查
`429`	超出请求频率上限	稍等；额度随累计充值提升
`500` / `503`	我方临时故障（`internal_error`、`processing_*`）	保留 `request_id`，退避重试，见错误码

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

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