Cherry Studio

Cherry Studio 适合多模型聊天和桌面使用。推荐先使用 OpenAI 兼容 Provider,获得最广泛的模型和客户端兼容性。

配置状态
  • 推荐协议: OpenAI Chat Completions
  • 配置格式核对: 2026-07-15(Cherry Studio 官方文档)
  • 运行验证: 待验证

1. 添加服务商

打开 设置 → 模型服务 → 添加自定义服务商,选择 OpenAI 兼容类型。

字段
名称GetRouter
API KeyYOUR_API_KEY
API 地址https://getrouter.ai/v1
模型MODEL_ID

如果版本将“API 地址”定义为完整 Endpoint,再使用 https://getrouter.ai/v1/chat/completions。不要同时让地址和客户端重复追加路径。

2. 添加模型

优先尝试拉取模型列表;失败时从模型目录手动添加 MODEL_ID。展示名称可以自定义,但请求模型 ID 必须准确。

3. 验证

  1. 选择 GetRouter Provider 和模型;
  2. 关闭联网、知识库、图片和工具;
  3. 发送短文本;
  4. 确认 /v1/chat/completions 请求成功;
  5. 再测试流式、图片和 Tool Calling。

常见问题

现象处理
模型列表为空手动添加模型,不代表聊天接口不可用
连接检查 404检查当前版本 API 地址是否自动追加 /v1
图片无法发送确认模型、协议和客户端都支持图片输入
工具调用失败普通聊天与 Tool Calling 要分开验证
多 Key 轮询异常先使用单个 Key 验证,不依赖非标准多 Key 格式