Cherry Studio 常见报错处理

API Key 无效

检查 API Key 是否填在 Xikapi provider 中，而不是填到了默认 OpenAI provider。

处理方式：

• 删除旧 Key 后重新粘贴。
• 确认没有复制到换行或空格。
• 确认当前聊天选择的是 Xikapi 模型。

模型列表为空

部分客户端不会自动拉取 Xikapi 模型列表，需要手动添加模型名称。

处理方式：

1. 到 Xikapi 后台复制模型名称。
2. 在 Cherry Studio 的模型列表中手动新增。
3. 保存后重新选择模型。

404 Not Found

通常是 API 地址写到了具体接口路径。

正确写法：

https://xikapi.com/v1

错误写法：

https://xikapi.com/v1/chat/completions

图片无法识别

图片理解需要同时满足：

• Cherry Studio 当前版本支持图片输入。
• 当前模型支持视觉能力。
• 对话中选择的是视觉模型。

如果不确定，先用纯文本消息验证模型连通。

流式输出中断

处理方式：

• 关闭流式输出后重试。
• 换一个模型测试。
• 检查网络代理是否拦截长连接。