Cherry Studio 接入

难度 🖱️ 简单（全程点鼠标，零代码）　|　类型 桌面软件（Windows / macOS）

Cherry Studio 是一款免费的桌面 AI 客户端，不用写任何代码。加上我们的接口，就能用各种模型聊天、写东西、处理文档。

开始之前

先到 控制台 → 令牌 创建一个 API Key（不会的话看 快速开始）。准备好形如 sk-xxxx 的 Key 再往下做。

第 1 步：下载并安装

打开官网 cherry-ai.com，下载对应你电脑的版本（Windows 或 macOS），像装普通软件一样装好、打开。

第 2 步：把"半页酥"加为服务商

1. 点左下角 设置（齿轮图标 ⚙️）。
2. 找到 模型服务 / 模型提供商，点 添加，类型选 OpenAI。
3. 填两样东西：
   • API 地址 / API Host：填 https://byesu.com
   • API 密钥 / API Key：粘贴你的 sk-xxxx

地址填完，检查一下这条

Cherry 通常会在下面显示一条实际请求地址预览。确认它是 https://byesu.com/v1/chat/completions。 如果变成了 …/v1/v1/…，把你刚填地址末尾多出来的 /v1 去掉即可。

第 3 步：添加要用的模型

在这个服务商下点 管理 / 添加模型，把模型名填进去 —— 名字要和 控制台 里写的一模一样（大小写、横杠都要对）。

想要最好的效果？直接填各平台最强旗舰：gpt-5.5、claude-opus-4-8、gemini-3.1-pro-high、grok-420-fast、a/glm-5.2（完整清单见 控制台）。

第 4 步：开始用 ✅

回到聊天界面，顶部选中刚加的模型，发一句"你好"。它能回你，就接通了！

卡住了？

• 报 401 / 令牌无效 → Key 填错或首尾带了空格（详情）
• 报 404 / 接口不对 → 检查第 2 步那条"地址预览"是不是 /v1/chat/completions
• 报 余额不足 → 去 控制台 充值（详情）
• 报 无可用渠道 → 模型名不对或不在你的分组（详情）
• 其它见 常见错误