故障排查

遇到问题？这里有一些常见问题的解决方案。

---

安装问题

依赖安装失败

# 清理缓存
uv cache clean

# 重新安装
uv sync

---

配置问题

ComfyUI 连接失败

可能原因: - ComfyUI 未运行 - URL 配置错误 - 防火墙阻止

解决方案: 1. 确认 ComfyUI 正在运行 2. 检查 URL 配置（默认 http://127.0.0.1:8188） 3. 在浏览器中访问 ComfyUI 地址测试 4. 检查防火墙设置

LLM API 调用失败

可能原因: - API Key 错误 - 网络问题 - 余额不足

解决方案: 1. 检查 API Key 是否正确 2. 检查网络连接 3. 查看错误提示中的具体原因 4. 检查账户余额

---

生成问题

视频生成失败

可能原因: - 工作流文件损坏 - 模型未下载 - 资源不足

解决方案: 1. 检查工作流文件是否存在 2. 确认 ComfyUI 已下载所需模型 3. 检查磁盘空间和内存

图像生成失败

解决方案: 1. 检查 ComfyUI 是否正常运行 2. 尝试在 ComfyUI 中手动测试工作流 3. 检查工作流配置

TTS 生成失败

解决方案: 1. 检查 TTS 工作流是否正确 2. 如使用声音克隆，检查参考音频格式 3. 查看错误日志

---

性能问题

生成速度慢

优化建议: 1. 使用本地 ComfyUI（比云端快） 2. 减少分镜数量 3. 使用更快的 LLM（如 Qianwen） 4. 检查网络连接

---

其他问题

仍有问题？

1. 查看项目 GitHub Issues
2. 提交新的 Issue 描述你的问题
3. 包含错误日志和配置信息以便快速定位

---

日志查看

日志文件位于项目根目录： - api_server.log - API 服务日志 - test_output.log - 测试日志