Cherry Studio 配置 AI 模型完整教程
Cherry Studio 是一款颜值与效率并重的跨平台 AI 对话客户端，它支持接入几乎所有主流大模型，而且配置方式比你想的更灵活。很多朋友安装后第一步就卡在“怎么把自己的 API 接进去”，今天这篇教程就帮你一次讲透，从零开始，让 DeepSeek、Qwen、Claude、Gemini 等模型在 Cherry Studio 里为你工作。
## 1. 获取 API 访问地址与密钥
无论你用哪家模型，都需要先拿到两个关键信息：**API 端点（Base URL）** 和 **API Key**。如果你已经直接从模型厂商（如 OpenAI、Anthropic）申请，可以直接跳过这一步，但要注意厂商接口可能不对国内网络友好，费用也较高。更方便的选择是使用兼容 OpenAI 格式的 API 中转服务，它能让你用一个 Key 调用多种模型，按量计费不浪费。
获得端点通常类似于 `https://api.example.com/v1`，而 Key 则是形如 `sk-xxxxxxxx` 的字符串，请务必保存好。
## 2. 在 Cherry Studio 中添加自定义模型提供方
打开 Cherry Studio，进入左下角 **设置 → 模型服务**。你会发现内置了 OpenAI、Groq 等多个预设，但如果你想接入其他兼容 OpenAI 接口的模型（比如 DeepSeek 或中转聚合服务），就要用到 **添加提供方** 功能。
点击“添加提供方”，在弹窗中填写：
- **提供方名称**：自定义，例如“我的中转站” - **类型**：选择 `OpenAI` 或 `OpenAI Compatible` - **API 地址**：粘贴你的 Base URL，注意结尾不要有额外的路径如 `/chat/completions`（Cherry Studio 会自动拼接） - **API Key**：粘贴你的密钥 - **模型列表**：可以先留空，后面手动输入模型 ID；也可以填写一个获取模型的接口路径，但手动填更可靠。
保存后，Cherry Studio 会将这个提供方加入你的服务列表。这时你可以继续为它添加具体的模型。
## 3. 添加具体模型与测试连接
在刚刚创建的提供方卡片下方，点击“添加模型”，输入准确的模型 ID，例如：
- DeepSeek-V3：`deepseek-chat` - 通义千问：`qwen-plus` 或 `qwen-max` - Claude 3.5 Sonnet：`claude-3-5-sonnet-20241022` - Gemini 1.5 Pro：`gemini-1.5-pro`
如果使用中转服务，模型 ID 一定要与服务商提供的完全一致。添加后点击右侧的“测试”按钮，Cherry Studio 会发送一条简短请求。如果一切正确，你会看到绿色的连接成功提示，否则请仔细检查 URL 和 Key 是否有空格或拼写错误。
下面是一个以环境变量思维的配置参考（仅是示意，实际在 UI 内操作）：
```bash # 你在 Cherry Studio 中填入的等效信息 PROVIDER_NAME="MyAggregator" BASE_URL="https://api.example.com/v1" API_KEY="sk-your-token-here" MODEL_ID="deepseek-chat" ```
## 4. 开始对话与高级玩法
配置完成后，回到主界面新建对话，在输入框上方的模型选择器里就能看到你刚添加的模型了。Cherry Studio 支持多模型同时回答对比、Markdown 渲染、代码高亮以及本地会话记录。你可以针对不同任务创建助手，并固定其模型，例如“翻译助手”绑定 Qwen，“创意写作”绑定 Claude，灵活切换无忧。
## 5. 一个高性价比的 API 方案推荐
如果你觉得分别注册多个模型厂商很麻烦，或者担心单家用量高峰时排队，可以试试 **TokenPocket API 中转站**（https://tokenpocket.site）。它完美兼容 OpenAI 接口格式，已集成 DeepSeek、Qwen、Claude、Gemini 等热门模型，全部按量计费，用多少付多少。新用户注册即赠送免费额度，足够你在 Cherry Studio 里完成初步体验和测试。配置方式跟上面完全一致，只需把 Base URL 换为 TokenPocket 提供的端点，Key 用平台生成的即可，省去了逐一对接厂商的繁琐步骤。
现在，打开你的 Cherry Studio，把模型接进来，用最顺手的前端去驾驭最强大脑。