Appearance
Cherry Studio 接入指南
Cherry Studio 是国产桌面 AI 客户端，支持多模型服务商与 OpenAI 兼容协议。接入 TopsDyne 后，可在统一界面使用全部模型。
配置方法
1. 添加服务商
打开 Cherry Studio：设置 → 模型服务 → 添加。
2. 选择 OpenAI 兼容
- 提供商类型选择 OpenAI 兼容
- 名称随意（如
TopsDyne） - 填入 API 地址：
https://api.topsdyne.com/v1 - 填入 API Key：
sk-xxx - 点击「添加」
3. 添加模型
在模型管理中手动添加在售模型 ID（在售模型与型号以控制台模型广场实时展示为准，示例占位：your-model-id），保存后即可在对话中切换。
协议说明
Cherry Studio 使用 OpenAI 兼容协议：
- Base URL：
https://api.topsdyne.com/v1（必须带 /v1） - 鉴权：
Authorization: Bearer sk-xxx
模型配置
推荐模型：在售模型与型号以控制台模型广场实时展示为准。
验证
在 Cherry Studio 新建对话，切换到添加的模型，发送消息确认正常。
故障排查
| 现象 | 处理 |
|---|---|
| 401 | API Key 错误 |
| 模型不存在 | 在「模型管理」中手动添加模型 ID 后再试 |
| 403 model not allowed | 当前套餐不含该模型，换用在售模型或升级套餐 |