# Cherry Studio 接入 OfoxAI 配置指南

Source: https://ofox.io/zh/docs/integrations/cherry-studio

[Cherry Studio](https://cherry-ai.com) 是一款跨平台的 AI 桌面客户端（支持 Windows、macOS、Linux），支持多模型对话、知识库和工作流，是目前功能最丰富的开源 AI 客户端之一。

通过配置 OfoxAI 作为服务商，你可以在 Cherry Studio 中使用 GPT、Claude、Gemini、DeepSeek 等 100+ 大模型，只需一个 API Key。

## 四种协议说明

Cherry Studio 支持通过以下四种协议接入 OfoxAI：

**OpenAI Chat** — 基于 `/v1/chat/completions`，适用于 GPT 系列模型，如 `openai/gpt-6.1-sol`、`openai/gpt-6-luna`。

**OpenAI Response** — 基于 `/v1/responses`，适用于 GPT 系列模型，如 `openai/gpt-6.1-sol`、`openai/gpt-6-luna`。

**Claude** — 基于 `/anthropic/v1/messages`，适用于 Claude 系列模型，如 `anthropic/claude-sonnet-5.5`、`anthropic/claude-opus-5.5`。

**Gemini** — 基于 `/gemini/v1beta/models`，适用于 Gemini 系列模型，如 `google/gemini-3.8-flash`、`google/gemini-3.5-flash-lite`。

## 前提条件

- 已注册 OfoxAI 账号并获取 API Key（[前往获取](https://app.ofox.io)）
- 已安装 Cherry Studio（[下载地址](https://cherry-ai.com)）

## 配置步骤

### 第 1 步：打开设置

启动 Cherry Studio，点击右上角的 **设置** 图标。

![打开 Cherry Studio 设置](https://ofox.io/screenshots/cherry-studio/01-open-settings.png)

### 第 2 步：添加模型提供商

进入左侧 **模型服务**，滚动到底部，点击 **+ 添加**。在弹出的对话框中填写提供商名称，并选择对应的提供商类型。

**OpenAI Chat**

提供商类型选择 `OpenAI`，点击确定。

![添加 OpenAI Chat 提供商](https://ofox.io/screenshots/cherry-studio/02-add-chat.png)

**OpenAI Response**

提供商类型选择 `OpenAI`（后续在配置页开启 Response 模式），点击确定。

![添加 OpenAI Response 提供商](https://ofox.io/screenshots/cherry-studio/02-add-response.png)

**Claude**

提供商类型选择 `Anthropic`，点击确定。

![添加 Claude 提供商](https://ofox.io/screenshots/cherry-studio/02-add-claude.png)

**Gemini**

提供商类型选择 `Gemini`，点击确定。

![添加 Gemini 提供商](https://ofox.io/screenshots/cherry-studio/02-add-gemini.png)

### 第 3 步：填写 API 配置

在对应提供商的配置页中填写 API 密钥和 API 地址。

**OpenAI Chat**

| 配置项 | 值 |
|--------|-----|
| **API 密钥** | 你的 OfoxAI API Key |
| **API 地址** | `https://api.ofox.io/v1` |

![OpenAI Chat 配置](https://ofox.io/screenshots/cherry-studio/03-config-chat.png)

**OpenAI Response**

| 配置项 | 值 |
|--------|-----|
| **API 密钥** | 你的 OfoxAI API Key |
| **API 地址** | `https://api.ofox.io/v1` |

![OpenAI Response 配置](https://ofox.io/screenshots/cherry-studio/03-config-response.png)

**Claude**

| 配置项 | 值 |
|--------|-----|
| **API 密钥** | 你的 OfoxAI API Key |
| **API 地址** | `https://api.ofox.io/anthropic` |

![Claude 配置](https://ofox.io/screenshots/cherry-studio/03-config-claude.png)

**Gemini**

| 配置项 | 值 |
|--------|-----|
| **API 密钥** | 你的 OfoxAI API Key |
| **API 地址** | `https://api.ofox.io/gemini` |

![Gemini 配置](https://ofox.io/screenshots/cherry-studio/03-config-gemini.png)

确认页面右上角的开关处于 **开启（ON）** 状态，否则该提供商不会出现在模型选择器中。

### 第 4 步：添加模型

点击模型区域的 **管理** 按钮自动拉取模型列表，点击模型右侧的 **+** 添加到启用列表。

**OpenAI Chat**

![OpenAI Chat 模型列表](https://ofox.io/screenshots/cherry-studio/04-model-chat.png)

**OpenAI Response**

![OpenAI Response 模型列表](https://ofox.io/screenshots/cherry-studio/04-model-response.png)

**Claude**

![Claude 模型列表](https://ofox.io/screenshots/cherry-studio/04-model-claude.png)

**Gemini**

![Gemini 模型列表](https://ofox.io/screenshots/cherry-studio/04-model-gemini.png)

### 第 5 步：验证配置

点击 **检测** 按钮，选择任意模型进行测试，显示检测通过即配置成功。

**OpenAI Chat**

![OpenAI Chat 验证](https://ofox.io/screenshots/cherry-studio/05-verify-chat.png)

**OpenAI Response**

![OpenAI Response 验证](https://ofox.io/screenshots/cherry-studio/05-verify-response.png)

**Claude**

![Claude 验证](https://ofox.io/screenshots/cherry-studio/05-verify-claude.png)

**Gemini**

![Gemini 验证](https://ofox.io/screenshots/cherry-studio/05-verify-gemini.png)

## 开始使用

回到主界面，点击对话顶部的模型选择器，在对应提供商分组下选择模型，即可开始对话。

![选择模型开始对话](https://ofox.io/screenshots/cherry-studio/06-start-chat.png)

## 图片生成

Cherry Studio 支持通过 Gemini 协议调用 OfoxAI 的图片生成模型，在对话中直接生成图片。

### 第 1 步：添加 Gemini 提供商

进入 **模型服务**，点击底部 **+ 添加**。

![添加提供商](https://ofox.io/screenshots/cherry-studio/img-01.jpg)

在弹出的对话框中，提供商类型选择 **Gemini**，点击确定。

![选择 Gemini 类型](https://ofox.io/screenshots/cherry-studio/img-02.jpg)

### 第 2 步：配置并获取生图模型

API 地址填写 `https://api.ofox.io/gemini`，点击 **获取模型列表**，添加以下生图模型：

- `Google: Nano Banana Pro (Gemini 3 Pro Image Preview)`
- `Google: Nano Banana (Gemini 2.5 Flash Image)`
- `Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview)`

![获取生图模型](https://ofox.io/screenshots/cherry-studio/img-03.jpg)

### 第 3 步：编辑助手，配置生图参数

在主界面右键点击助手，选择 **编辑助手**。

![编辑助手](https://ofox.io/screenshots/cherry-studio/img-04.jpg)

在编辑页面中：
1. **默认模型** 选择刚添加的生图模型
2. 点击 **+ 添加参数**，添加以下两个自定义参数：

| 参数名 | 类型 | 值 |
|--------|------|-----|
| `responseModalities` | JSON | `["IMAGE"]` |
| `imageConfig` | JSON | `{"aspectRatio": "1:1", "imageSize": "1K"}` |

`imageConfig` 中可以调整图片的宽高比和分辨率，如需 2K 图片，将 `imageSize` 改为 `"2K"`。

![配置生图参数](https://ofox.io/screenshots/cherry-studio/img-05.jpg)

### 第 4 步：开始生图

保存配置后，在对话框中输入图片描述，即可生成图片。

![生图效果](https://ofox.io/screenshots/cherry-studio/img-06.jpg)

## 新版 Cherry Studio：一个服务商，多种协议

新版 Cherry Studio 支持在同一个服务商里为每种协议分别设置请求地址。只需添加一个 OfoxAI 服务商，就能同时使用 GPT、Claude、Gemini 模型，并支持图像生成与图像编辑。

### 第 1 步：填写请求配置

在服务商配置页填好 API 密钥后，打开 **请求配置**，按下表填写各协议的地址，点击 **保存**：

| 协议 / 字段 | 地址 |
|------|------|
| **OpenAI（默认）** | `https://api.ofox.io/v1` |
| **Anthropic** | `https://api.ofox.io/anthropic` |
| **Gemini** | `https://api.ofox.io/gemini` |
| **OpenAI Responses** | `https://api.ofox.io/v1` |
| **图像生成 Base URL** | `https://api.ofox.io/v1` |
| **图像编辑 Base URL** | `https://api.ofox.io/v1` |

![请求配置：OpenAI、Anthropic、Gemini、OpenAI Responses 地址](https://ofox.io/screenshots/cherry-studio/new-01-request-config.jpg)

![请求配置：图像生成与图像编辑 Base URL](https://ofox.io/screenshots/cherry-studio/new-02-request-config-image.jpg)

**设为默认** 决定普通对话默认使用哪种协议。**图像生成 Base URL** 对应 `/images/generations`，**图像编辑 Base URL** 对应 `/images/edits`，留空时使用默认对话端点的 Base URL。截图中使用的是镜像地址 `api.ofox.io`，大陆网络可直接照填；其他网络使用 `api.ofox.io`。

### 第 2 步：多模型对话

添加模型后，在同一个服务商下即可切换 Gemini、GPT、Claude 等不同厂商的模型对话，下图依次为 Gemini 3.8 Flash、GPT-6 Luna、Claude Sonnet 5.5：

![同一服务商下使用 Gemini、GPT、Claude 模型对话](https://ofox.io/screenshots/cherry-studio/new-05-multi-protocol-chat.jpg)

### 第 3 步：图像生成与编辑

添加图像模型（如 `openai/gpt-image-2`）后，在绘画页选择该模型，输入描述即可生成图片：

![使用 GPT-Image-2 生成图片](https://ofox.io/screenshots/cherry-studio/new-03-image-generate.jpg)

上传一张参考图并输入修改指令（如「变成一只狗」），即可基于原图编辑：

![使用 GPT-Image-2 编辑图片](https://ofox.io/screenshots/cherry-studio/new-04-image-edit.jpg)

## 常见问题

**Q: 点击「管理」后模型列表为空**

检查 API 地址是否填写正确（末尾不加斜杠），以及 API 密钥是否完整复制，无多余空格。

**Q: 检测时提示连接失败**

1. 确认 API Key 从 [OfoxAI 控制台](https://app.ofox.io) 完整复制，无多余空格
2. 确认 API 地址填写正确
3. 确认网络连接正常

**Q: 提供商不出现在模型选择器中**

检查配置页右上角的开关是否已开启。