故障排查
模型与 Provider 问题
排查模型列表为空、认证失败、额度或频率受限,以及 Ollama 和 ComfyUI 连接失败。
模型没有出现在选择列表里
打开「AI 模型配置」,检查「已配置的 Provider」和「可用模型列表」,在有「测试连接」按钮时先测试。使用 Raydo 积分时,到「设置 → 云端」确认账号已登录。如果已经更改默认模型,但某条对话、某个角色或工作流仍然报错,检查它实际选中的模型。生成图片、视频或音频时,到对应工作台检查模型选择项。
认证、余额或频率报错
- 认证需要重新连接。 检查账号连接,或在 Provider 设置中更新密钥。密钥如果已经泄露,先在服务商处撤销,再填写新密钥。如果受支持的 WeToken 连接要求填写 API Base URL,请用
https://wetoken.one/v1。 - 余额或权益不可用。 托管模型检查 Raydo 积分,自带密钥的模型检查服务商账单。OpenRouter 单独计费。
- 触发频率或额度限制。 到服务商账号页检查配额,等限制解除再试。如果对话显示已切换模型,查看回复旁标出的实际模型和切换原因。
Ollama 或 ComfyUI 测试失败
打开「设置 → 本地能力」,确认服务已启动,从运行 Raydo 的电脑上点「测试」。填写服务的基础地址,例如本机 ComfyUI 的 http://127.0.0.1:8188。Raydo 接受本机或私有网络内的地址。如果已连通但列表为空,先下载 Ollama 模型,或向 ComfyUI 添加底模,再测一次。保存后,在模型选择列表里选 Ollama 测试纯文本对话,或在图片工作台选 ComfyUI 生成一张测试图片。
验证语言模型时,先发一条纯文本消息。如果纯文本能回复,添加附件或其他输入才失败,请确认所选模型支持该输入类型。连接设置参阅连接 Provider。