Skip to content

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,不要直接用于本教程。


配置步骤

  1. 打开 Cherry Studio,进入 设置 → 模型服务
  2. 点击服务商列表下方的 添加
  3. 服务商名称填写 Exact Relay,服务商类型选择 OpenAI,然后保存
  4. 在新服务商中填写:
字段填写内容
API 密钥sk-xxx
API 地址https://exactrelay.com/v1

Cherry Studio 会自动在该根地址后拼接 /chat/completions,不要重复填写完整路径。

  1. 点击 添加模型,填入模型广场中的准确模型 ID,例如 gpt-5.6-sol
  2. 打开服务商右上角的启用开关
  3. 点击 检查 验证连接;通过后即可在聊天界面选择该模型

常见问题

返回 404

API 地址应填写根地址 https://exactrelay.com/v1。如果手动填了完整 /chat/completions 路径,Cherry Studio 可能再次拼接路径。

返回 403 block

当前 Key 很可能限制了客户端类型或要求特定 User-Agent。请改用明确允许普通第三方客户端的分组或 Key。

检测通过但模型列表里看不到

确认已经手动添加模型,并打开服务商右上角的启用开关。

返回模型不存在

回到模型广场复制当前分组实际提供的模型 ID,不要照抄旧教程中的型号。