# Pixelle-Video 常见问题与解决方案
## 安装问题
### Q：uv 命令找不到
**问题描述**
终端提示 `uv: command not found`
**解决方案**
1. 重启终端
2. 如果使用 macOS/Linux，执行：
“`bash
source ~/.bashrc # 或
source ~/.zshrc
“`
3. 验证安装：
“`bash
uv –version
“`
### Q：ffmpeg 安装失败
**问题描述**
ffmpeg 安装报错或下载速度慢
**解决方案**
– macOS：使用 `brew install ffmpeg`
– Ubuntu/Debian：使用 `sudo apt install ffmpeg`
– Windows：下载预编译包，将 bin 目录加入 PATH
### Q：依赖安装卡住
**问题描述**
`uv run` 卡在依赖安装环节
**解决方案**
1. 使用国内镜像源
2. 或手动创建虚拟环境安装：
“`bash
uv venv
source .venv/bin/activate
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
“`
## 配置问题
### Q：LLM API 调用失败
**问题描述**
提示 API Key 错误或账户余额不足
**解决方案**
1. 确认 API Key 正确
2. 检查账户余额
3. 确认 Base URL 正确
4. 测试网络连接到 API 服务器
### Q：ComfyUI 连接失败
**问题描述**
提示无法连接到 ComfyUI
**解决方案**
1. 确认 ComfyUI 已启动
2. 检查端口（默认 8188）是否被占用
3. 确认 ComfyUI URL 配置正确
4. 检查防火墙设置
### Q：配置无法保存
**问题描述**
点击保存配置无反应
**解决方案**
1. 检查配置文件写入权限
2. 以管理员身份运行程序
3. 检查磁盘空间
## 生成问题
### Q：视频生成时间过长
**问题描述**
生成一个视频需要很长时间
**解决方案**
– 减少分镜数量
– 使用更快的 LLM
– 本地部署 ComfyUI
– 减少图像尺寸
– 使用量化模型
### Q：图像生成失败
**问题描述**
某个分镜的图像生成失败
**解决方案**
1. 检查 ComfyUI 服务状态
2. 简化提示词
3. 检查模型是否正确加载
4. 降低图像尺寸
### Q：语音不同步
**问题描述**
语音和图像不同步
**解决方案**
1. 调整语速（降低可加快生成）
2. 减少文案长度
3. 检查模板设置
4. 重新生成
### Q：视频画面异常
**问题描述**
视频画面闪烁、变形或显示错误
**解决方案**
1. 更换视频模板
2. 检查图像尺寸是否匹配模板
3. 确认模板 HTML 语法正确
4. 清除缓存重新生成
## 效果优化
### Q：文案质量不高
**解决方案**
– 更换 LLM 模型
– 优化提示词
– 提供更具体的主题
– 使用固定文案模式
### Q：图像风格不统一
**解决方案**
– 统一 Prompt Prefix
– 使用固定种子
– 选择风格一致的模型
### Q：语音效果不自然
**解决方案**
– 更换 TTS 引擎
– 优化参考音频质量
– 调整语速和音调
– 改善文案标点
## 费用问题
### Q：如何实现零成本运行
**解决方案**
– LLM：使用 Ollama 本地部署
– 图像生成：ComfyUI 本地部署
– TTS：使用 Edge-TTS（免费）
### Q：通义千问费用多少
**解决方案**
通义千问 API 按 token 计费，价格低廉。实际成本取决于文案长度，通常一个短视频成本不到 0.1 元。
## 其他问题
### Q：输出文件在哪里
**解决方案**
生成的视频保存在 `output/` 文件夹，包括：
– MP4 视频文件
– 分镜图片（images/）
– 语音文件（audio/）
– 文案原文（script.txt）
### Q：如何批量生成视频
**解决方案**
1. 准备多个主题列表
2. 循环调用生成接口
3. 或使用命令行模式批量处理
### Q：可以自定义模板吗
**解决方案**
可以。在 `templates/` 文件夹中创建 HTML 模板文件，命名遵循 `static_*/image_*/video_*.html` 规范。
## 获取帮助
– GitHub Issues：https://github.com/AIDC-AI/Pixelle-Video/issues
– 提交详细的问题描述和错误日志