Cherry Studio

Cherry Studio 是桌面聊天客户端，适合同时管理多个服务商、模型和知识库。Sprelay API 可作为 OpenAI Compatible 服务商接入。

方式一：从 Sprelay 一键导入

1. 在电脑上安装并打开 Cherry Studio。
2. 登录 Sprelay，打开API 密钥。
3. 找到准备给 Cherry Studio 使用的密钥。
4. 打开该密钥的操作菜单，选择 Cherry Studio 或对应的一键配置入口。
5. 浏览器询问是否打开 Cherry Studio 时，核对目标应用后允许。
6. 回到 Cherry Studio，检查服务地址、密钥和模型列表。

一键导入入口是否显示，取决于站点和浏览器对自定义协议的支持。没有入口时使用手动方式。

方式二：手动配置

在 Cherry Studio 的模型服务设置中新增 OpenAI Compatible 服务：

字段	填写值
服务商名称	Sprelay API
API 密钥	在 Sprelay 创建的独立密钥
API 地址	https://sprelaytoken.com/v1
模型	从模型广场或模型列表复制

保存后执行连接检查，或在聊天页面创建一个新助手进行最小对话。

添加模型

如果客户端不能自动拉取模型：

1. 打开模型广场。
2. 确认密钥分组支持目标模型。
3. 复制完整模型名称。
4. 在 Cherry Studio 的该服务商中手动添加模型。

模型 ID 必须完整一致。显示名称可以自定义，但请求使用的模型 ID 不应改写。

推荐的密钥设置

• 名称设置为 Cherry Studio。
• 选择常用聊天模型所在分组。
• 首次使用设置较小额度。
• 如果只使用固定模型，启用模型限制。

常见问题

测试连接返回 401

重新从密钥页面复制完整密钥，确认没有多余空格，并检查密钥是否启用。

返回 404

确认 API 地址是 https://sprelaytoken.com/v1，而不是完整的 /chat/completions 路径，也不是重复的 /v1/v1。

模型列表为空

密钥分组可能没有可用模型，或客户端没有成功同步。先调用模型列表接口，再手动添加返回的模型名称。

聊天能用但图片或工具调用失败

不同能力需要模型和协议同时支持。先在模型广场确认模型能力，再查看工具调用。图片能力会在完成当前模型与端点验证后单独发布。