API 接入 AI 工具研究员 1 views

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 后,按下面路径操作:

  1. 点击左下角或侧边栏的 设置
  2. 找到 模型服务 / Model Provider
  3. 选择 添加服务商
  4. 如果列表里有 OpenAI Compatible,优先选择它
  5. 如果没有,也可以选择“自定义 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"
}

这里需要注意三点:

  1. Base URL 必须带 /v1
    不要只填 https://api-ic.stillhappy.cn,否则可能请求失败。

  2. API Key 必须完整复制
    示例中的 sk-xxx 只是格式演示,实际要在 https://stillhappy.cn 注册并进入控制台获取。

  3. 模型名要和服务商后台一致
    如果后台显示的是 gpt-5,就不要手写成 gpt5;如果后台已开放 gpt-5.5,也要按后台模型列表原样填写。


四、选择模型并测试对话

配置完成后,回到 Cherry Studio 主界面。

操作步骤:

  1. 新建一个聊天窗口
  2. 在模型下拉框中选择刚才配置的服务商
  3. 选择模型,例如 gpt-5claude-sonnet-4-6gemini-2.5-pro
  4. 输入一句测试提示词:
请用 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.5gpt-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-5claude-sonnet-4-6gemini-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

Cherry Studio 接入 GPT-5.5
相关阅读