Cherry Studio 接入 OpenAI 兼容 API 教程
Cherry Studio 添加自定义模型服务商的完整步骤：Base URL 与 Key 的填写位置、模型名配置、多服务商切换与常见问题。
内容复核中：以下为保留的旧稿，不代表本站接入实测；配置、价格与模型信息请以对应产品当前官方文档为准。
Cherry Studio 是一款流行的开源桌面 AI 客户端（Windows / macOS / Linux），支持同时挂多个模型服务商。这篇记录给它添加 OpenAI 兼容服务商的完整流程。
为什么选 Cherry Studio
- 开源免费，界面干净
- 一个界面管理多家模型，随时切换
- 知识库、翻译、绘图等周边功能齐全
- 对 OpenAI 兼容协议支持完善
配置步骤
第 1 步：打开服务商设置
进入 设置 → 模型服务，底部点 添加。
第 2 步：填写服务商信息
需要填三项：
| 字段 | 填什么 |
|---|---|
| 名称 | 随意，方便自己辨认即可 |
| API Base URL | 你的端点地址（一般以 /v1 结尾） |
| API Key | 服务商提供的密钥 |
第 3 步：添加模型
在服务商详情页点 添加模型，填入端点实际支持的模型 ID。这里的模型名必须和端点注册的完全一致。
第 4 步：验证
回到对话界面，选中刚添加的模型，发一条消息。正常回复即配置成功。
多服务商管理技巧
Cherry Studio 的优势在于多服务商并存：
- 默认模型：设置里可以分别指定「默认对话模型」「默认命名模型」等，建议把轻量任务指给便宜的小模型
- 快速切换：对话界面左下角可以随时切换当前模型，不同任务用不同模型是控制成本的要点
- 助手模板：可以给常用场景（翻译、总结、代码审查）建立助手，各自绑定固定的模型
常见问题
测试连接失败
- Base URL 末尾多了或少了
/v1——以服务商文档为准，这是第一大错误来源 - Key 复制时带了空格或换行
- 端点需要特定的 Referer 或自定义 Header（少数服务有此要求，看服务商文档）
回复内容为空或乱码
通常是端点的流式（SSE）实现有问题。在服务商设置里关闭「流式传输」试试，如果关闭后正常，问题在端点侧。
模型列表拉取失败
有些端点支持 /v1/models 自动拉取模型列表，有些不支持。拉取失败不影响手动添加模型，手动填就行。
小结
Cherry Studio 的配置逻辑就是「服务商 = Base URL + Key，模型 = 手动填 ID」。理解了这一点，任何 OpenAI 兼容的端点都能在两分钟内挂上来。
相关阅读：新手第一次配置 API 的完整流程