企业官网建设流程全解析

HunyuanVideo 文生视频部署指南：ComfyUI 插件与量化模型选型

【免费下载链接】HunyuanVideoHunyuanVideo: A Systematic Framework For Large Video Generation Model项目地址: https://gitcode.com/gh_mirrors/hu/HunyuanVideo

用 HunyuanVideo 文生视频模型（text-to-video，输入文字生成视频）在本地跑一段 5 秒 720p 视频，你多半会撞上两个坎：显存不够，官方口径 720p 起步要 60GB；路线太多，官方脚本、HunyuanVideo ComfyUI 插件、GGUF 量化版本，不知道先上哪条。这篇文章不做排名：先把每条路线的显存账和安装成本摊开对比，再用命令把它真正跑起来。

⚖️ 工具选型：HunyuanVideo 低显存部署的三条路线

路线一：官方推理脚本。仓库里的 sample_video.py 是最小入口，运行脚本 已预填参数，官方侧还附了多卡并行与 Gradio 网页接口。它解决的是离第一段视频最近的路径；代价是没有可视化界面，参数全靠命令行拼接。

路线二：ComfyUI 插件。README 的社区贡献区列了两个：原生集成（ComfyUI 官方维护，开箱即用）和社区 Wrapper（Kijai 开发，多了 FP8 推理（8 位浮点量化）、视频转视频、图生视频等开关）。前者稳定，后者功能多，但属于社区维护，装之前要先确认它兼容当前的模型版本。

路线三：GGUF 量化版。GGUF 是一种社区量化格式，位宽越低、显存占用越小。社区的 HunyuanVideo-gguf 提供多个位宽，适合显存 40GB 以下的卡，代价是画质折损，具体差距以你自己的硬件实测为准。

显存压力的根源在架构：13B 参数，双流转单流的 Transformer 主干加全注意力，视频要先经 3D VAE 压缩成潜空间再进入去噪环节。

🧩 部署步骤：从克隆到第一段视频的 4 步

前提：Linux 机器 + NVIDIA CUDA 显卡（官方测试环境为 Linux）。

第 1 步，克隆代码：

git clone https://gitcode.com/gh_mirrors/hu/HunyuanVideo cd HunyuanVideo

执行完你会看到项目根目录，里面有 依赖清单、ckpts、hyvideo、scripts 等子目录。

第 2 步，建环境装依赖：

conda create -n HunyuanVideo python==3.10.9 conda activate HunyuanVideo python -m pip install -r requirements.txt

装完能看到 torch 2.6.0、diffusers 0.31.0 等固定版本已就位。

第 3 步，下载模型权重：

python -m pip install "huggingface_hub[cli]" huggingface-cli download tencent/HunyuanVideo --local-dir ./ckpts

下载完成后 模型目录 下会出现 transformers、vae、text_encoder 等权重文件；下载支持断点续传，中断后重跑即可。

第 4 步，跑第一段视频：

bash scripts/run_sample_video.sh

脚本预填了 720×1280 竖屏、129 帧、50 步；跑完会在 ./results 里得到一个 mp4。显存紧张时先降到 544×960，或改用下面的量化路线。

⚠️ 效果与避坑：官方显存数据 + 两个报错

官方口径的数字：720px×1280px×129 帧最低 60GB 显存，544px×960px×129 帧 45GB，建议 80GB 卡；多卡并行在 1280×720×129 帧 50 步下，1 卡 1904 秒、8 卡 337.6 秒，约 5.6 倍加速；官方另提供 FP8 权重，可再省约 10GB 显存。

报错一：FP8 模式下提示 Invalid fp8_map path。原因是--use-fp8开启后--dit-weight没指向 fp8 权重，或同目录缺少_map.pt缩放系数文件（见 fp8_optimization.py）。把路径指到mp_rank_00_model_states_fp8.pt、确认同目录有mp_rank_00_model_states_fp8_map.pt即可，也可以直接改 FP8 脚本 顶部的DIT_CKPT_PATH。

报错二：下载权重时报No such file or directory: 'ckpts/.huggingface/...'。这是下载工具的已知现象，可以忽略，重跑下载命令即可，支持续传。

收尾：一条命令起步

显存 48GB 以下，别硬扛 720p 原始权重：降到 544×960，或换官方 FP8、GGUF 量化；手里有 80GB 的卡，直接bash scripts/run_sample_video.sh出第一段视频。仓库的 News 区更新频繁（I2V、Avatar 等模型陆续放出），建议持续跟踪仓库，以免插件与量化版本的适配信息过期。

【免费下载链接】HunyuanVideoHunyuanVideo: A Systematic Framework For Large Video Generation Model项目地址: https://gitcode.com/gh_mirrors/hu/HunyuanVideo