Cherry Studio 接入

Cherry Studio 是桌面端 AI 聊天客户端（Windows / macOS / Linux），通过添加 OpenAI 兼容提供商接入 Router。

• 协议：OpenAI Chat Completions
• 接入地址：https://routerapi.<你的域名>/v1

准备工作

1. 登录 Router 控制台，签发一个 Key 并保存明文
2. 在控制台「快速接入」页记下 OpenAI Chat Completions 协议的接入地址
3. 从 Cherry Studio 官网下载并安装客户端

配置

1. 打开 Cherry Studio → 左下角设置（齿轮图标） → 模型服务
2. 点击添加（添加提供商），类型选择 OpenAI（OpenAI 兼容），名称随意（如 VeyraOS Router）
3. 在刚添加的提供商上：
   • API 地址填：https://routerapi.<你的域名>/v1
   • API 密钥填你的 Key
4. 点添加模型（或在模型管理处添加），模型名填控制台「可用模型」列表中的名称（如路由池名）
5. 打开该提供商的启用开关

验证

回到对话页，顶部模型选择切到刚添加的提供商与模型，发一条消息。正常流式回复即接入成功；控制台「调用记录」出现调用明细。

常见问题

Q：添加模型时「检查」失败？ 检查 API 地址必须以 /v1 结尾；密钥完整粘贴（sk- 开头）；模型名与控制台「可用模型」列表完全一致。

Q：回复到一半中断？ 检查网络对数据面域名的连通性；长回复受上游通道影响，重试一般可恢复（路由层会自动切换备用通道）。