Cherry Studio 接入 BetterToken:自定义服务商、API Host 与模型
在 Cherry Studio 中以 OpenAI 或 Anthropic 协议添加 BetterToken 自定义服务商,添加 Model ID,检测连接并排查常见错误。
在 Cherry Studio 中添加自定义服务商,填写 BetterToken API Key 和 API Host,再从模型广场添加当前可用的 Model ID。
重点信息
| 字段 | 值 |
|---|---|
| 服务商类型 | OpenAI(OpenAI 兼容) |
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai(API Host) |
| Model | 模型广场中的 Model ID |
准备工作
已有账号?登录并充值,然后在控制台创建 API Key。
安装
从官网或 GitHub Releases 下载对应系统的 Cherry Studio,安装后打开。无需额外插件。
手动配置
在 Cherry Studio 设置界面完成配置,无需编辑配置文件。
添加自定义服务商
打开 Settings → Model Provider,点击 Add,名称填 BetterToken,类型选择 OpenAI。
填写 API Key 和 API Host
- API Key → BetterToken API Key
- API Host →
https://bettertoken.ai
Cherry Studio 会自动补全请求路径。请确认输入框下方的请求地址预览为 https://bettertoken.ai/v1/chat/completions,不要把完整的 /chat/completions 地址填进 API Host。
添加模型
点击 Manage 获取模型列表,或点击 Add 手动填写 Model ID,例如 claude-sonnet-5-5、gpt-6-sol、deepseek-flash。
检测连接
点击 Check,选择一个已添加的模型,看到成功提示后启用该服务商。
使用 Anthropic 协议
使用 Claude 模型时,你可以再添加一个类型为 Anthropic、API Host 为 https://bettertoken.ai 的自定义服务商。Cherry Studio 会将请求发往 /v1/messages。这个服务商只用于 Claude 模型,其他模型继续使用 OpenAI 类型的服务商。
验证连接
新建对话,选择 BetterToken 模型,发送 只回复一个词:OK。正常回复说明配置成功。
切换模型
在对话的模型选择器中选择另一个 BetterToken 模型。如果列表中还没有该模型,打开 BetterToken 服务商,点击 Add,填入模型广场中的准确 Model ID。
常见错误
| 错误 | 检查项 |
|---|---|
401 / Unauthorized | 检查 BetterToken API Key,去掉首尾空格。 |
404 | API Host 应为 https://bettertoken.ai,预览中 /v1/chat/completions 只出现一次。 |
model not found | 从模型广场复制当前 Model ID。 |
| 模型列表为空 | 点击 Add 手动填写 Model ID。 |
进阶配置
相关指南
技术说明
协议与 endpoint
OpenAI 类型的服务商请求 https://bettertoken.ai/v1/chat/completions;Anthropic 类型的服务商请求 https://bettertoken.ai/v1/messages。两种情况下 API Host 都只填 https://bettertoken.ai。

