CS

Cherry Studio 接入指南

本指南将帮助您将 GPT-Load 代理服务接入到 Cherry Studio AI 客户端中,支持 OpenAI、Gemini、Gemini OpenAI 兼容和 Anthropic 四种渠道类型。

前置条件

确保您已经成功部署并启动了 GPT-Load 服务,默认运行在 http://localhost:3001

通用添加步骤

服务添加位置

访问设置页面

在 Cherry Studio 左下角点击 “设置” → “模型服务”

添加新服务

在页面底部点击 “添加” 按钮(请勿使用列表中现有的服务)

配置完成后获取模型

点击 “管理” 按钮,获取模型列表并选择需要的模型

重要提醒

所有渠道类型都遵循相同的添加流程:选择供应商类型 → 配置 API 地址和密钥 → 获取模型列表。 只是供应商类型和 API 地址配置有所不同。

1
OpenAI 渠道配置

步骤一:创建服务

创建步骤

输入服务名称

为您的服务设置一个易于识别的名称

选择供应商类型

OpenAI

在供应商类型下拉列表中选择 OpenAI

Cherry Studio OpenAI 服务创建截图

点击图片放大查看

步骤二:配置服务

配置参数

配置 API 密钥

sk-123456

使用您在 GPT-Load 中配置的代理密钥

设置 API 地址

http://localhost:3001/proxy/openai

其中 “openai” 是您在 GPT-Load 中配置的分组名称

获取模型列表

配置完成后点击 “管理” 按钮,获取并选择所需模型

Cherry Studio OpenAI 服务配置截图

点击图片放大查看

2
Gemini 渠道配置

步骤一:创建服务

创建步骤

输入服务名称

为您的 Gemini 服务设置一个易于识别的名称

选择供应商类型

Gemini

在供应商类型下拉列表中选择 Gemini

Cherry Studio Gemini 服务创建截图

点击图片放大查看

步骤二:配置服务

配置参数

配置 API 密钥

sk-123456

使用您在 GPT-Load 中配置的代理密钥

设置 API 地址

http://localhost:3001/proxy/gemini

其中 “gemini” 是您在 GPT-Load 中配置的分组名称

获取模型列表

配置完成后点击 “管理” 按钮,获取并选择所需模型

Cherry Studio Gemini 服务配置截图

点击图片放大查看

3
Gemini OpenAI 兼容格式

步骤一:创建服务

使用 Gemini 渠道的 OpenAI 兼容接口格式

创建步骤

输入服务名称

为您的 Gemini OpenAI 兼容服务设置名称

选择供应商类型

OpenAI

使用 OpenAI 类型以支持兼容接口

Cherry Studio Gemini OpenAI 兼容服务创建截图

点击图片放大查看

步骤二:配置服务

配置参数

配置 API 密钥

sk-123456

使用您在 GPT-Load 中配置的代理密钥

设置 API 地址

http://localhost:3001/proxy/gemini/v1beta/openai/

注意:地址必须以 “/” 结尾,避免 Cherry Studio 自动添加 v1 路径

获取模型列表

配置完成后点击 “管理” 按钮,获取并选择所需模型

Cherry Studio Gemini OpenAI 兼容服务配置截图

点击图片放大查看

关键配置注意

API 地址必须以 “/” 结尾!这是 Cherry Studio 的规则要求, 确保不会自动添加 v1 路径,从而保证兼容性接口正常工作。

4
Anthropic (Claude) 渠道配置

步骤一:创建服务

创建步骤

输入服务名称

为您的 Anthropic 服务设置一个易于识别的名称

选择供应商类型

Anthropic

在供应商类型下拉列表中选择 Anthropic

Cherry Studio Anthropic 服务创建截图

点击图片放大查看

步骤二:配置服务

配置参数

配置 API 密钥

sk-123456

使用您在 GPT-Load 中配置的代理密钥

设置 API 地址

http://localhost:3001/proxy/anthropic

其中 “anthropic” 是您在 GPT-Load 中配置的分组名称

获取模型列表

配置完成后点击 “管理” 按钮,获取并选择所需模型

Cherry Studio Anthropic 服务配置截图

点击图片放大查看

重要说明

配置注意事项

• 请将示例中的 GPT-Load 访问地址替换为您实际的服务地址

• 路径中的分组名称(如 openai、gemini、anthropic)需要与您在 GPT-Load 中的实际配置保持一致

• 使用您在 GPT-Load 中配置的实际代理密钥,不要使用示例中的 sk-123456

• 配置完成后,记得在对话界面选择刚才添加的模型进行测试