Cherry Studio 模型列表为空怎么办？

先看结论：90% 是这三个原因

七步排查法

第 1 步：核对 Base URL

进入 设置 → 模型服务 → 你添加的服务商，检查 API 地址。

正确格式：

https://lbwapishop.online/v1

检查三点：有没有 https://、有没有 /v1、结尾有没有多余的斜杠。

第 2 步：检查 API Key

把 Key 复制到记事本，看看首尾有没有空格或换行。这是最隐蔽的坑，肉眼看不出来。

另外确认 Key 是从当前这个中转站的控制台生成的，别家站的 Key 不通用。

第 3 步：确认服务商已启用

配置页顶部有个「启用」开关，打开它。没启用的话，即使配置全对，模型也不会出现在聊天页的模型选择器里。

第 4 步：手动添加模型

不要依赖自动拉取。在服务商的模型输入框里直接输入模型名，按回车添加：

gpt-4o
gpt-4o-mini
deepseek-chat

模型名从控制台的「模型」页复制，注意大小写和连字符，别自己改。

第 5 步：点「获取模型列表」

如果服务商配置页有「获取模型列表」或「刷新模型」按钮，点一下。它会向 /v1/models 发请求拉取可用模型。

点了没反应或者报错，说明前面三步有问题，回去检查。

第 6 步：用 curl 验证接口

绕过 Cherry Studio 直接测接口，能快速判断是软件问题还是配置问题：

curl https://lbwapishop.online/v1/models \
  -H "Authorization: Bearer sk-你的key"

返回 JSON 模型列表 → 接口没问题，问题在 Cherry Studio 配置
返回 401 → Key 错
返回 404 → URL 错
超时 → 网络问题

第 7 步：重启软件

配置改完没生效的话，完全退出 Cherry Studio 再打开。不是关窗口，是从托盘图标右键退出。

其他常见错误

报错 401 Unauthorized

Key 错了。重新从控制台复制一个，注意别带空格。

报错 404 Not Found

URL 少了 /v1，或者模型名不存在。

报错 ECONNREFUSED / 连接超时

网络访问不到中转站。浏览器打开中转站首页试试，打不开就是网络问题，可能需要换网络环境。

模型列表有但聊天报错

模型名添加了但实际不可用。用 curl 测一下这个具体模型：

curl https://lbwapishop.online/v1/chat/completions \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","messages":[{"role":"user","content":"hi"}]}'

解锁版模型用不了

解锁版和普通版走同一套接口，只是模型名不同。确认两点：控制台里确实有这个分组、令牌绑定到了该分组。

解锁版是什么、怎么判断好坏，见破甲模型完整指南。

完整配置示例

照这个填，基本不会错：

还不行？

把这三样发给客服，基本能定位问题：

• 完整报错截图
• 你填的 API 地址（Key 不用发）
• Cherry Studio 版本号

TG 客服 @jiali66888。完整的配置步骤见Cherry Studio 接入教程。