Cherry Studio 报错：模型连接失败
Cherry Studio 添加服务商后连不上的排查。，附原因排序、修复步骤与责任判定。
更新 2026-10-28
核验 2026-10-28 · 码农阿风
cherry-studio桌面端
30 秒结论
Cherry Studio 的服务商配置里，API 地址和模型名要分别填对。
报错原文对照
请求失败，请检查配置
404 Not Found原因排序
| 概率 | 原因 |
|---|---|
| 45% | API 地址没写 /v1 |
| 30% | 模型名不在列表 |
| 25% | Key 无效 |
修法
先在自己这边查
- API 地址加到 /v1
- 手动添加模型名
- 用软件内的检测按钮验证
再往服务方查
- 确认中转站支持该格式
责任判定表
| 现象 | 责任方 |
|---|---|
| 检测按钮报错 | 配置 |
| 对话报错 | 模型或 Key |
| 只有某个模型不行 | 命名 |
什么时候该换
Cherry Studio 的模型列表需要手动维护，不会自动同步。
你在这个站点上遇到过这个问题？
认领站点后可补充证据、申请公开核验；认证不改榜单排序，只对应可复核的检测与复测。
认领 / 申请认证