不少人装好 Cherry Studio 之后，真正卡住的不是软件怎么用，而是模型怎么接。
打开「模型服务」后，会看到几个很容易混淆的东西：
- API Key 填什么
- Base URL 是什么
- Model 模型名称从哪里找
- 为什么填完 API Key 还是没有模型
- 第三方大模型 API 怎么接进 Cherry Studio
其实 Cherry Studio 的模型配置逻辑并不复杂。
如果只是使用 DeepSeek、Kimi、智谱、豆包、阿里百炼等已经内置的服务商，通常填好 API Key，再添加模型就可以使用。
如果使用的是第三方 API、聚合 API 或其他 OpenAI 兼容接口，则需要额外配置 API 地址和模型 ID。
下面按实际配置过程讲一遍。
配置前先了解三个核心参数
无论接哪家大模型，基本都绕不开三个参数：
| 参数 | 是什么 | 从哪里获取 |
|---|---|---|
| API Key | 调用模型时使用的身份凭证 | API 服务商控制台 |
| Base URL | API 请求发送到哪里 | API 服务商文档或控制台 |
| Model | 实际调用的模型 ID | 模型列表或控制台 |
可以简单理解成：
API Key = 你的调用凭证
Base URL = 模型接口地址
Model = 具体要使用哪个模型
这里最容易混淆的是 Base URL。
它不是模型名称，也不是 API Key，更不是服务商官网地址。
同一个 API 服务商可能提供多个模型，但这些模型可以共用同一个接口地址，只需要通过不同的 Model ID 来区分。
内置模型服务商的配置方式
Cherry Studio 已经内置了不少模型服务商，包括 DeepSeek、Moonshot AI（Kimi）、智谱、豆包、阿里百炼、MiniMax 等。
如果使用这些已经预置好的服务商，通常不需要自己研究接口协议。
打开：
设置 → 模型服务
找到对应的服务商。
例如使用 DeepSeek，就选择 DeepSeek；使用 Kimi，则找到对应的 Moonshot AI。
接下来通常按照这个流程操作：
填写 API Key ↓ 获取模型列表 ↓ 添加需要的模型 ↓ 检测连接 ↓ 启用服务商内置服务商很多情况下已经预设好了 API 地址，所以主要需要准备的就是 API Key。
API Key 需要从对应模型服务商的开放平台或控制台获取。
注意，这里填写的不是账号密码，而是专门用于 API 调用的密钥。
模型列表的获取与添加
填写 API Key，并不代表模型已经自动添加完成。
配置好密钥以后，还需要尝试：
获取模型列表
然后把需要使用的模型添加进 Cherry Studio。
只有已经加入模型列表的模型，后续才会出现在模型选择界面。
这里还要注意一个细节：
模型展示名称和真正用于 API 调用的 Model ID 不一定完全相同。
例如同一个系列可能同时存在：
模型 A 模型 A-某版本 模型 A-某日期版本真正调用时使用的，还是对应的 Model ID。
因此不确定时，最好直接参考服务商当前模型列表。
第三方 API 的接入方法
如果使用的 API 服务商没有出现在 Cherry Studio 的预置列表中，也不一定不能用。
Cherry Studio 支持通过自定义服务商接入第三方 API。
进入：
设置 → 模型服务
找到添加自定义服务商的位置。
然后填写一个方便识别的服务商名称，例如：
自定义大模型 API接下来要判断服务商使用的是什么接口协议。
如果对方文档中明确出现：
OpenAI Compatible 兼容 OpenAI API 兼容 OpenAI SDK通常可以选择 OpenAI 类型进行配置。
然后填写三个核心参数：
API Key Base URL Model ID如果服务商支持自动获取模型列表，可以直接获取。
如果不能自动获取，也可以根据接口文档手动添加 Model ID。
Base URL 的填写注意事项
Base URL 是第三方 API 配置里比较容易出错的一项。
假设服务商提供的是：
https://api.example.com或者：
https://api.example.com/v1应该按照对方接口文档要求填写。
有些文档还会直接给出完整请求地址，例如：
https://api.example.com/v1/chat/completions这种情况下，不要看到一个地址就直接全部复制进去。
Cherry Studio 通常会根据选择的接口类型自动拼接对应的请求路径，因此应该优先使用服务商明确标注的Base URL / API 地址。
比较稳妥的方式是：
直接复制 API 服务商控制台或官方文档提供的 Base URL。
尤其不要把：
https://www.example.com这种官网首页地址，当成：
https://api.example.com这样的 API 地址。
两者不是一回事。
OpenAI 兼容接口的基本逻辑
现在不少大模型平台都会写：
OpenAI Compatible
这里并不是说它一定使用 OpenAI 的模型。
它表达的是：
这套 API 在调用格式上兼容 OpenAI API 的部分规范。
因此很多原本支持 OpenAI API 的客户端，也可以通过更换：
API Key Base URL Model来接入其他兼容服务。
这也是 Cherry Studio 可以比较方便地连接不同模型和第三方 API 的原因之一。
但要注意：
OpenAI 兼容，不等于所有功能都完全一样。
基础对话一般比较容易兼容，但 Thinking、工具调用、多模态、联网搜索等功能，仍然要看具体模型和 API 服务商是否支持。
配置完成后的检测与启用
API Key、Base URL 和模型都填完以后，建议先进行一次连接检测。
选择一个已经添加的模型进行测试。
如果检测正常，再确认对应模型服务商已经处于启用状态。
完整流程可以记成：
获取 API Key ↓ 进入模型服务 ↓ 填写 API Key ↓ 确认 Base URL ↓ 获取或添加模型 ↓ 检测连接 ↓ 启用服务商 ↓ 选择模型使用如果前面的参数都配置正确，但聊天界面仍然找不到模型，也可以回来检查一下服务商是否已经启用。
常见配置问题排查
如果检测连接失败，不一定需要重新安装 Cherry Studio。
很多时候只是某个参数没有填对。
可以按照这个顺序排查：
API Key ↓ Base URL ↓ Model ID ↓ 模型服务商是否启用 ↓ 当前 API 是否支持获取模型列表API Key
确认 Key 有没有复制完整，以及是不是当前服务商提供的 Key。
尤其不要混用不同平台的 API Key。
Base URL
确认填写的是 API 地址，而不是官方网站。
使用第三方 API 时，以服务商提供的 Base URL 为准。
Model ID
建议直接从服务商当前模型列表复制，不要自己猜模型名称。
获取不到模型列表
部分 API 服务不一定支持客户端自动拉取模型列表。
这种情况下，可以根据服务商文档提供的 Model ID 手动添加模型。
API Key 的安全使用
还有一个很容易忽略的问题。
Cherry Studio 模型配置页面中的 API Key，本质上就是你的 API 调用凭证。
所以无论是发教程、截图提问，还是分享到群里，都建议把完整 Key 打码。
不要把真实 API Key 放到：
公开截图 博客文章 代码仓库 评论区 公开聊天记录如果发现 Key 已经意外公开，建议及时到对应服务商后台撤销，并重新生成新的密钥。
写在最后
Cherry Studio 配置大模型 API，核心其实就是弄清楚三个参数：
API Key、Base URL、Model。
使用内置服务商时，通常填好 API Key、添加模型即可。
如果使用第三方或聚合 API，则重点确认接口协议，再按照服务商提供的信息填写API Key、Base URL 和 Model ID。
把这几个参数对应好，基础的模型接入基本就完成了。
