# Pixelle-Video 快速上手指南
## 首次启动
安装完成后，启动 Pixelle-Video：
“`bash
# 使用 uv 运行
uv run streamlit run web/app.py
# 或 Windows 一键整合包
双击 start.bat
“`
浏览器自动打开 http://localhost:8501
## 界面布局
Pixelle-Video 采用三栏布局：
| 左侧栏 | 中间栏 | 右侧栏 |
|——–|——–|——–|
| 内容输入 | 语音和视觉设置 | 视频生成 |
## 快速配置
### 1. 系统配置（首次必填）
点击展开「⚙️ 系统配置」面板：
**LLM 配置**
– 选择预设模型（通义千问、GPT-4o、DeepSeek 等）
– 或手动配置 API Key、Base URL、Model
**图像配置**
– 本地部署：配置 ComfyUI URL（默认 http://127.0.0.1:8188）
– 云端部署：配置 RunningHub API Key
点击「保存配置」
### 2. 内容输入
**AI 生成内容模式**
1. 选择「AI 生成内容」
2. 输入视频主题（如”为什么要养成阅读习惯”）
3. AI 自动创作文案
**固定文案模式**
1. 选择「固定文案内容」
2. 直接输入完整文案
3. 系统跳过 AI 创作环节
**背景音乐设置**
– 无 BGM：纯人声解说
– 内置音乐：选择预置背景音乐
– 自定义音乐：放入 bgm/ 文件夹
### 3. 语音设置
**TTS 工作流**
– 选择 TTS 引擎（Edge-TTS、Index-TTS 等）
– 系统自动扫描 workflows/ 文件夹
**参考音频（可选）**
– 上传 MP3/WAV/FLAC 格式音频
– 用于声音克隆（Index-TTS）
**预览功能**
– 输入测试文本
– 点击「预览语音」试听效果
### 4. 视觉设置
**图像生成**
– 选择 ComfyUI 工作流
– 设置图像尺寸（默认 1024×1024）
– 填写 Prompt Prefix（风格描述，英文）
**视频模板**
– 选择模板（static_*/image_*/video_*.html）
– 按尺寸分组：竖屏/横屏/方形
### 5. 生成视频
配置完成后，点击「🎬 生成视频」
进度显示：
1. 生成文案
2. 生成配图
3. 合成语音
4. 合成视频
生成完成自动播放预览，显示时长、文件大小、分镜数等信息。
## 完整示例
### 制作”阅读习惯”科普视频
1. **系统配置**
– LLM：通义千问
– 图像：本地 ComfyUI
2. **内容输入**
– 模式：AI 生成内容
– 主题：为什么要养成阅读习惯
3. **语音设置**
– TTS：Edge-TTS
– 声音：中文女声
4. **视觉设置**
– 工作流：image_flux.json
– 尺寸：1024×1024
– Prompt：Minimalist illustration, clean lines, simple sketch style
– 模板：image_portrait.html（竖屏）
5. **生成**
– 点击生成，等待几分钟
## 输出文件
生成的视频保存在 `output/` 文件夹，包括：
– 完整 MP4 视频
– 分镜图片
– 语音文件
– 文案原文
## 下一步
熟悉基本操作后，可以深入学习系统配置、视频模板、TTS 工作流等高级功能。