quick-start.md - Pixelle-Video

quick-start.md

1	# 快速开始
2
3	已经完成安装和配置？让我们生成第一个视频吧！
4
5	---
6
7	## 启动 Web 界面
8
9	### Windows 一键整合包用户
10
11	如果你使用的是 Windows 一键整合包，只需：
12	1. 双击运行 `start.bat`
13	2. 浏览器会自动打开 `http://localhost:8501`
14
15	### 从源码安装用户
16
17	```bash
18	# 使用 uv 运行
19	uv run streamlit run web/app.py
20	```
21
22	浏览器会自动打开 `http://localhost:8501`
23
24	---
25
26	## 生成你的第一个视频
27
28	### 步骤一：检查配置
29
30	首次使用时，展开「⚙️ 系统配置」面板，确认已配置：
31
32	- LLM 配置: 选择 AI 模型（如通义千问、GPT 等）并填入 API Key
33	- 图像配置: 配置 ComfyUI 地址或 RunningHub API Key
34
35	如果还没有配置，请查看 [配置说明](configuration.md)。
36
37	配置好后点击「保存配置」。
38
39	---
40
41	### 步骤二：输入主题
42
43	在左侧栏的「📝 内容输入」区域：
44
45	1. 选择「AI 生成内容」模式
46	2. 在文本框中输入一个主题，例如：
47	```
48	为什么要养成阅读习惯
49	```
50	3. （可选）设置场景数量，默认 5 个分镜
51
52	!!! tip "主题示例"
53	- 为什么要养成阅读习惯
54	- 如何提高工作效率
55	- 健康饮食的重要性
56	- 旅行的意义
57
58	---
59
60	### 步骤三：配置语音和视觉
61
62	在中间栏：
63
64	语音设置
65	- 选择 TTS 工作流（默认 Edge-TTS 即可）
66	- 如需声音克隆，可上传参考音频
67
68	视觉设置
69	- 选择图像生成工作流（默认即可）
70	- 设置图像尺寸（默认 1024x1024）
71	- 选择视频模板（推荐竖屏 1080x1920）
72
73	---
74
75	### 步骤四：生成视频
76
77	点击右侧栏的「🎬 生成视频」按钮！
78
79	系统会显示实时进度：
80	- 生成文案
81	- 生成配图（每个分镜）
82	- 合成语音
83	- 合成视频
84
85	!!! info "生成时间"
86	生成一个 5 分镜的视频大约需要 2-5 分钟，具体时间取决于：LLM API 响应速度、图像生成速度、TTS 工作流类型、网络状况
87
88	---
89
90	### 步骤五：预览视频
91
92	生成完成后，视频会自动在右侧栏播放！
93
94	你可以看到：
95	- 📹 视频预览播放器
96	- ⏱️ 视频时长
97	- 📦 文件大小
98	- 🎬 分镜数量
99	- 📐 视频尺寸
100
101	视频文件保存在 `output/` 文件夹中。
102
103	---
104
105	## 下一步探索
106
107	恭喜！你已经成功生成了第一个视频 🎉
108
109	接下来你可以：
110
111	- 调整风格 - 查看 [自定义视觉风格](../tutorials/custom-style.md) 教程
112	- 克隆声音 - 查看 [使用参考音频克隆声音](../tutorials/voice-cloning.md) 教程
113	- 使用 API - 查看 [API 使用指南](../user-guide/api.md)
114	- 开发模板 - 查看 [模板开发指南](../user-guide/templates.md)
115
116

116 lines MARKDOWN