Cherry Studio 接入指南
本指南将帮助您将 GPT-Load 代理服务接入到 Cherry Studio AI 客户端中,支持 OpenAI、Gemini、Gemini OpenAI 兼容和 Anthropic 四种渠道类型。
前置条件
确保您已经成功部署并启动了 GPT-Load 服务,默认运行在 http://localhost:3001
通用添加步骤
服务添加位置
访问设置页面
在 Cherry Studio 左下角点击 “设置” → “模型服务”
添加新服务
在页面底部点击 “添加” 按钮(请勿使用列表中现有的服务)
配置完成后获取模型
点击 “管理” 按钮,获取模型列表并选择需要的模型
重要提醒
所有渠道类型都遵循相同的添加流程:选择供应商类型 → 配置 API 地址和密钥 → 获取模型列表。 只是供应商类型和 API 地址配置有所不同。
1OpenAI 渠道配置
步骤一:创建服务
创建步骤
输入服务名称
为您的服务设置一个易于识别的名称
选择供应商类型
OpenAI
在供应商类型下拉列表中选择 OpenAI

点击图片放大查看
步骤二:配置服务
配置参数
配置 API 密钥
sk-123456
使用您在 GPT-Load 中配置的代理密钥
设置 API 地址
http://localhost:3001/proxy/openai
其中 “openai” 是您在 GPT-Load 中配置的分组名称
获取模型列表
配置完成后点击 “管理” 按钮,获取并选择所需模型

点击图片放大查看
2Gemini 渠道配置
步骤一:创建服务
创建步骤
输入服务名称
为您的 Gemini 服务设置一个易于识别的名称
选择供应商类型
Gemini
在供应商类型下拉列表中选择 Gemini

点击图片放大查看
步骤二:配置服务
配置参数
配置 API 密钥
sk-123456
使用您在 GPT-Load 中配置的代理密钥
设置 API 地址
http://localhost:3001/proxy/gemini
其中 “gemini” 是您在 GPT-Load 中配置的分组名称
获取模型列表
配置完成后点击 “管理” 按钮,获取并选择所需模型

点击图片放大查看
3Gemini OpenAI 兼容格式
步骤一:创建服务
使用 Gemini 渠道的 OpenAI 兼容接口格式
创建步骤
输入服务名称
为您的 Gemini OpenAI 兼容服务设置名称
选择供应商类型
OpenAI
使用 OpenAI 类型以支持兼容接口

点击图片放大查看
步骤二:配置服务
配置参数
配置 API 密钥
sk-123456
使用您在 GPT-Load 中配置的代理密钥
设置 API 地址
http://localhost:3001/proxy/gemini/v1beta/openai/
注意:地址必须以 “/” 结尾,避免 Cherry Studio 自动添加 v1 路径
获取模型列表
配置完成后点击 “管理” 按钮,获取并选择所需模型

点击图片放大查看
关键配置注意
API 地址必须以 “/” 结尾!这是 Cherry Studio 的规则要求, 确保不会自动添加 v1 路径,从而保证兼容性接口正常工作。
4Anthropic (Claude) 渠道配置
步骤一:创建服务
创建步骤
输入服务名称
为您的 Anthropic 服务设置一个易于识别的名称
选择供应商类型
Anthropic
在供应商类型下拉列表中选择 Anthropic

点击图片放大查看
步骤二:配置服务
配置参数
配置 API 密钥
sk-123456
使用您在 GPT-Load 中配置的代理密钥
设置 API 地址
http://localhost:3001/proxy/anthropic
其中 “anthropic” 是您在 GPT-Load 中配置的分组名称
获取模型列表
配置完成后点击 “管理” 按钮,获取并选择所需模型

点击图片放大查看
重要说明
配置注意事项
• 请将示例中的 GPT-Load 访问地址替换为您实际的服务地址
• 路径中的分组名称(如 openai、gemini、anthropic)需要与您在 GPT-Load 中的实际配置保持一致
• 使用您在 GPT-Load 中配置的实际代理密钥,不要使用示例中的 sk-123456
• 配置完成后,记得在对话界面选择刚才添加的模型进行测试