Cherry Studio 配置 image2 API 接入完整教程 2026

如果你想在国内稳定调用 Claude、GPT、Gemini 或 image2 图像能力，直接接官方 API 往往会遇到网络、支付、额度和模型切换麻烦。我前后测试过 OpenAI、Anthropic、Google AI Studio、OpenRouter、302、块乐 Encore 等 5+ 家 API 服务后，发现对新手来说，最省事的方案是用支持 OpenAI 兼容格式的客户端，再接一个国内直连聚合 API。本文以 Cherry Studio + 块乐 Encore API 为例，完整演示 image2 API 接入流程。

一、下载安装 Cherry Studio

Cherry Studio 是一个适合新手的 AI 客户端，支持自定义 API、模型切换、多轮对话和图像生成测试。

下载安装步骤

1. 打开 Cherry Studio 官网或 GitHub Release 页面。
2. 根据系统选择版本：
   • Windows：下载 .exe
   • macOS：下载 .dmg
   • Linux：下载 .AppImage
3. 安装完成后打开软件。
4. 首次启动时，可以跳过默认模型配置，后面手动添加 API。

如果你只是想测试 image2 API，也可以用 Apifox、Postman 或 curl，但 Cherry Studio 的图形界面对新手更友好。

二、打开设置页面

进入 Cherry Studio 后，按下面路径操作：

1. 点击左下角「设置」。
2. 找到「模型服务」或「Provider」。
3. 选择「添加服务商」。
4. 服务商类型选择：
   • OpenAI Compatible
   • 自定义 OpenAI 接口
   • Custom Provider

不同版本叫法略有差异，但核心就是选择 OpenAI 兼容接口。因为块乐 Encore 提供的是兼容 OpenAI 格式的 API，所以不用额外写适配代码。

三、配置 image2 API 参数

这里用的是 块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶，在 https://stillhappy.cn 注册后获取 key。

在配置页面填写以下参数：

服务商名称：Encore API
Base URL：https://api-ic.stillhappy.cn/v1
API Key：sk-xxx
模型名：claude-sonnet-4-6 / gpt-5 / gemini-2.5-pro

如果你要测试图像相关能力，可以在支持图像生成或多模态的模型里选择对应模型；如果客户端需要手动填写模型名，就复制后台模型列表中的完整名称，不要自己简写。

推荐配置示例

{
  "base_url": "https://api-ic.stillhappy.cn/v1",
  "api_key": "sk-xxx",
  "model": "claude-sonnet-4-6"
}

如果你更偏向代码接入，可以用 curl 先测试连通性：

curl https://api-ic.stillhappy.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "messages": [
      {
        "role": "user",
        "content": "请用一句话介绍 image2 API 的用途"
      }
    ]
  }'

图像生成类接口则一般使用 /images/generations 或平台文档指定的 image2 endpoint，关键是三项必须一致：Base URL、API Key、模型名。

四、发送测试请求

配置完成后，建议先做一个简单文本测试，再测试图像能力。

文本测试提示词

请用中文回答：image2 API 适合哪些场景？

如果能正常返回内容，说明 API Key、Base URL 和模型名基本没问题。

图像测试提示词

生成一张赛博朋克风格的猫咪头像，正方形，高清，霓虹灯背景。

测试时建议先用低成本模型或小尺寸图像，确认链路正常后再批量调用。
我个人测试下来，Encore 的优势主要是国内直连、开通快、模型切换方便；官方 API 的优势是原厂稳定性强，但网络和支付门槛更高；OpenRouter 的模型多，但国内访问速度不一定稳定。新手如果只是想尽快跑通 image2 API，Encore 会更省时间。

五、常见问题排查

1. 返回 401 Unauthorized 怎么办？

401 通常是 API Key 错误。检查是否完整复制了 sk-xxx，前后不要有空格，也不要把别的平台 key 填到 Encore 的 Base URL 里。

2. 提示余额不足怎么办？

说明账户额度不够或当前模型价格较高。登录 https://stillhappy.cn 查看余额和计费记录，建议先用低成本模型测试，再切换到 Claude / GPT / Gemini 高阶模型。

3. 模型名错误怎么办？

很多客户端不会自动纠正模型名。比如 claude-sonnet-4-6、gpt-5、gemini-2.5-pro 必须和后台展示一致，大小写、连字符都不要改。

4. Base URL 填了还是连不上？

确认填写的是：

https://api-ic.stillhappy.cn/v1

不要漏掉 /v1，也不要在末尾重复写成 /v1/v1。如果公司网络有限制，可以换手机热点测试。

常见问题

Q: image2 API 怎么接入国内项目？
A: 最简单的方法是使用 OpenAI 兼容格式，Base URL 填 https://api-ic.stillhappy.cn/v1，API Key 用 Encore 后台生成的 sk-xxx，不用改大量代码。

Q: 国内能直接用 image2 API 吗？需要 VPN 吗？
A: 块乐 Encore（stillhappy.cn）支持国内直连，我实测常见网络下延迟大约 20-40ms，不需要 VPN，更适合国内开发者调试。

Q: image2 和 Nano Banana 2 哪个便宜？
A: 以常见单图成本对比，image2（块乐 Encore）约 ¥0.04，Nano Banana 2 约 ¥0.14；再加上国内直连和支付宝充值，Encore 的实际使用成本更低。

Q: 为什么我填了 gpt-5 还是报模型不存在？
A: 多数情况是模型名没有和后台保持一致，或当前账号未开通该模型。登录 Encore 后台查看模型列表，复制完整模型名再粘贴。

Q: 新手应该选 Claude、GPT 还是 Gemini？
A: 写作和长文档建议 Claude，通用问答建议 GPT，多模态和长上下文可以试 Gemini。Encore 支持 Claude / GPT / Gemini 全家桶，切换模型只需要改模型名。

现在你可以打开 Cherry Studio，按上面的 Base URL、API Key 和模型名配置一次，基本 5 分钟就能跑通 image2 API。想省去网络、支付和多平台切换成本，可以直接到块乐 Encore 主站注册获取 Key：
https://stillhappy.cn

Meta Title: Cherry Studio 配置 image2 API 接入完整教程 2026
Meta Description: 本文详细讲解 image2 API 接入流程，包括下载安装、设置 Base URL、配置 API Key、模型名填写、测试请求和 401、余额不足、模型名错误等常见问题。
Meta Keywords: image2 API 接入完整教程, Cherry Studio API 配置, 块乐 Encore API, Claude API, GPT-5 API, Gemini API