Appearance
Cherry Studio 接入配置
Cherry Studio 是国内社区常用的开源 AI 客户端。官网:cherryai.com;项目地址:CherryHQ/cherry-studio;自定义服务商官方文档。
接入前确认
本教程使用 Cherry Studio 的 OpenAI 兼容服务商,客户端会调用 /v1/chat/completions。请准备:
- 一个允许普通第三方 Chat Completions 客户端调用的 API Key
- 当前分组实际提供的模型 ID,可从站点模型广场复制
如果 Key 只允许 Codex CLI,或强制要求特定
User-Agent,不要直接用于本教程。
配置步骤
- 打开 Cherry Studio,进入 设置 → 模型服务
- 点击服务商列表下方的 添加
- 服务商名称填写
Exact Relay,服务商类型选择 OpenAI,然后保存 - 在新服务商中填写:
| 字段 | 填写内容 |
|---|---|
| API 密钥 | sk-xxx |
| API 地址 | https://exactrelay.com/v1 |
Cherry Studio 会自动在该根地址后拼接 /chat/completions,不要重复填写完整路径。
- 点击 添加模型,填入模型广场中的准确模型 ID,例如
gpt-5.6-sol - 打开服务商右上角的启用开关
- 点击 检查 验证连接;通过后即可在聊天界面选择该模型
常见问题
返回 404
API 地址应填写根地址 https://exactrelay.com/v1。如果手动填了完整 /chat/completions 路径,Cherry Studio 可能再次拼接路径。
返回 403 block
当前 Key 很可能限制了客户端类型或要求特定 User-Agent。请改用明确允许普通第三方客户端的分组或 Key。
检测通过但模型列表里看不到
确认已经手动添加模型,并打开服务商右上角的启用开关。
返回模型不存在
回到模型广场复制当前分组实际提供的模型 ID,不要照抄旧教程中的型号。