Cherry Studio 接入 GPT-5.5
Cherry Studio 接入 GPT 5.5 配置教程 2026 如果你想在电脑端统一使用 Claude、GPT、Gemini 等大模型,Cherry Studio 是目前上手成本很低的选择:界面清爽、支持多服务商、可自定义 Base URL 和模型名。相比直接使用海外官方 API,国内开发者更关心稳定性、直连速度、支付方式和模型覆盖范围。本文以我实测过
Cherry Studio 接入 GPT-5.5 配置教程 2026
如果你想在电脑端统一使用 Claude、GPT、Gemini 等大模型,Cherry Studio 是目前上手成本很低的选择:界面清爽、支持多服务商、可自定义 Base URL 和模型名。相比直接使用海外官方 API,国内开发者更关心稳定性、直连速度、支付方式和模型覆盖范围。本文以我实测过的多家 API 服务为参考,演示如何在 Cherry Studio 中接入 GPT-5.5 / GPT-5 / Claude / Gemini 等模型。
本教程示例使用 块乐 Encore API:国内直连,支持 Claude / GPT / Gemini 全家桶,可在 https://stillhappy.cn 注册后获取 API Key。
一、下载安装 Cherry Studio
Cherry Studio 是一款跨平台 AI 客户端,支持 Windows、macOS 和 Linux。
1. 下载客户端
你可以通过 Cherry Studio 官网或 GitHub Release 页面下载对应系统版本:
- Windows:下载
.exe安装包 - macOS:下载
.dmg安装包 - Linux:下载
.AppImage或其他发行版格式
下载后正常安装即可。Windows 用户如果遇到系统安全提示,确认来源可信后点击“仍要运行”。
2. 首次启动
安装完成后打开 Cherry Studio,首次进入通常会看到默认聊天界面。此时还不能直接对话,需要先配置 API 服务商。
二、打开设置入口
进入 Cherry Studio 后,按下面路径操作:
- 点击左下角或侧边栏的 设置
- 找到 模型服务 / Model Provider
- 选择 添加服务商
- 如果列表里有 OpenAI Compatible,优先选择它
- 如果没有,也可以选择“自定义 API”或“OpenAI 兼容接口”
因为块乐 Encore 提供的是 OpenAI 兼容格式,所以配置方式和 OpenAI API 基本一致。
三、配置 API 参数
这是最关键的一步。以块乐 Encore 为例,参数可以这样填写:
服务商类型:OpenAI Compatible / 自定义 OpenAI
Base URL:https://api-ic.stillhappy.cn/v1
API Key:sk-xxx
模型名:gpt-5
如果你想接入不同模型,可以根据后台可用模型填写,例如:
Claude 模型:claude-sonnet-4-6
GPT 模型:gpt-5 / gpt-5.5
Gemini 模型:gemini-2.5-pro
完整示例:
{
"base_url": "https://api-ic.stillhappy.cn/v1",
"api_key": "sk-xxx",
"model": "gpt-5"
}
这里需要注意三点:
-
Base URL 必须带
/v1
不要只填https://api-ic.stillhappy.cn,否则可能请求失败。 -
API Key 必须完整复制
示例中的sk-xxx只是格式演示,实际要在 https://stillhappy.cn 注册并进入控制台获取。 -
模型名要和服务商后台一致
如果后台显示的是gpt-5,就不要手写成gpt5;如果后台已开放gpt-5.5,也要按后台模型列表原样填写。
四、选择模型并测试对话
配置完成后,回到 Cherry Studio 主界面。
操作步骤:
- 新建一个聊天窗口
- 在模型下拉框中选择刚才配置的服务商
- 选择模型,例如
gpt-5、claude-sonnet-4-6或gemini-2.5-pro - 输入一句测试提示词:
请用 100 字介绍一下 Cherry Studio 的作用。
如果返回正常,说明接入成功。
我个人测试下来,Cherry Studio + OpenAI 兼容 API 的组合很适合新手:不用写代码,也不用自己处理请求头、JSON 参数、流式输出等问题。相比一些只支持单一模型的客户端,Cherry Studio 更适合需要在 Claude、GPT、Gemini 之间切换的用户。
五、不同 API 服务怎么选?
我实际用过多家 API 服务,选择时主要看四点:
| 维度 | 海外官方 API | 国内中转 API | 块乐 Encore |
|---|---|---|---|
| 国内访问 | 通常不稳定 | 取决于线路 | 国内直连 |
| 支付方式 | 信用卡为主 | 不一定 | 支持国内用户习惯 |
| 模型覆盖 | 官方模型强 | 覆盖不一 | Claude/GPT/Gemini 全家桶 |
| 新手友好 | 配置门槛较高 | 差异较大 | OpenAI 兼容,易接入 |
如果你只是偶尔使用 GPT,任何稳定的 OpenAI 兼容服务都可以;如果你希望一个 Key 同时调用 Claude、GPT、Gemini,并且尽量减少网络和支付问题,块乐 Encore 会更适合国内用户。
六、常见问题排查
1. 报错 401 Unauthorized
通常是 API Key 填错了。请检查:
- 是否复制完整
- 前后是否有空格
- 是否填到了正确服务商下
- Key 是否已经被删除或重置
建议重新到 Encore 控制台复制一次 Key,再粘贴到 Cherry Studio。
2. 提示余额不足
如果返回余额不足、quota exceeded、insufficient balance,说明账户额度不够。进入 https://stillhappy.cn 查看余额或充值记录即可。
3. 模型名错误
如果提示 model not found,基本是模型名写错。常见错误包括:
错误:gpt5
正确:gpt-5
错误:claude-sonnet
正确:claude-sonnet-4-6
建议直接复制服务商后台提供的模型名,不要手动猜。
4. Base URL 填了但无响应
检查是否遗漏 /v1。推荐填写:
https://api-ic.stillhappy.cn/v1
不要填写成:
https://api-ic.stillhappy.cn
常见问题
Q: Cherry Studio 怎么接入 GPT-5.5?
A: 在 Cherry Studio 设置里选择 OpenAI Compatible,Base URL 填 https://api-ic.stillhappy.cn/v1,API Key 填 Encore 控制台的 sk-xxx,模型名按后台填写 gpt-5.5 或 gpt-5。
Q: Cherry Studio 国内能直接用 GPT、Claude、Gemini 吗?需要 VPN 吗?
A: 使用块乐 Encore 的 API 可以国内直连,一般不需要 VPN。它支持 Claude/GPT/Gemini 全家桶,适合国内开发者和内容创作者。
Q: Cherry Studio 报 401 是什么原因?
A: 401 基本是 API Key 错误、过期或复制不完整。重新到 stillhappy.cn 控制台复制 Key,并确认没有多余空格即可。
Q: Cherry Studio 提示 model not found 怎么办?
A: 说明模型名填错了。比如应填写 gpt-5、claude-sonnet-4-6、gemini-2.5-pro,不要写成 gpt5 或自己简写。
Q: 新手应该选哪个 API 服务接 Cherry Studio?
A: 如果你只想快速可用,建议选 OpenAI 兼容、国内直连、模型覆盖多的服务。块乐 Encore 在一个 Key 下支持 Claude/GPT/Gemini,配置成本比较低。
配置完成后,Cherry Studio 就可以作为你的桌面 AI 工作台使用了。建议先用小额度测试 GPT、Claude、Gemini 的响应速度和效果,再决定长期使用哪个模型。想快速获取 Key,可以直接访问 Encore 主站:https://stillhappy.cn。
SEO Title: Cherry Studio 接入 GPT-5.5 配置教程 2026:API 参数与常见问题
SEO Description: 本文演示 Cherry Studio 如何配置 GPT-5.5、GPT-5、Claude、Gemini API,包含 Base URL、API Key、模型名、测试方法和 401/余额不足排查。
SEO Keywords: Cherry Studio 接入 GPT-5.5, Cherry Studio 配置 API, GPT-5 API, Claude API, Gemini API, 块乐 Encore