HunyuanVideo项目视频生成脚本变更说明

HunyuanVideo项目近期对其视频生成脚本进行了优化整合，将原先的并行处理脚本功能合并到了主脚本中。这一变更简化了项目的文件结构，提高了代码维护性，同时保持了原有的功能完整性。

脚本整合背景

在早期版本中，HunyuanVideo项目包含两个独立的视频生成脚本：sample_video.py和sample_video_parallel.py。前者用于单机视频生成，后者专门处理并行计算场景。随着项目发展，开发团队决定将这两个脚本的功能合并，统一到sample_video.py中。

变更内容

现在用户只需使用sample_video.py一个脚本，通过不同的参数配置即可实现：

• 单机视频生成
• 多GPU并行视频生成
• 不同分辨率和长度的视频生成

使用方法

要使用并行视频生成功能，现在可以通过以下命令实现：

torchrun --nproc_per_node=4 sample_video.py \
    --video-size 1280 720 \
    --video-length 129 \
    --infer-steps 50 \
    --prompt "A cat walks on the grass, realistic style." \
    --flow-reverse \
    --seed 42 \
    --ulysses_degree 4 \
    --ring_degree 1 \
    --save-path ./results

参数说明

• --nproc_per_node: 指定使用的GPU数量
• --video-size: 设置生成视频的分辨率
• --video-length: 控制生成视频的帧数
• --infer-steps: 推理步数，影响生成质量
• --prompt: 文本提示词
• --flow-reverse: 可选参数，控制视频流方向
• --seed: 随机种子，确保结果可复现
• --ulysses_degree/--ring_degree: 并行计算相关参数
• --save-path: 结果保存路径

技术优势

这一变更带来了几个显著优势：

1. 代码维护更加集中，减少了重复代码
2. 用户接口更加统一，降低了学习成本
3. 功能扩展更加方便，未来可以统一添加新特性

对于开发者而言，这种整合也使得代码架构更加清晰，有利于长期的项目维护和功能迭代。

注意事项

用户在使用时需要注意，新版本中所有视频生成功能都通过sample_video.py实现，不再需要区分不同脚本。如果遇到类似"找不到文件"的错误，应该检查是否使用了最新的代码版本。