[系列教程](/zh/tutorial "系列教程")[ComfyUI 进阶教程](/zh/tutorial/advanced "ComfyUI 进阶教程")5.2. 腾讯混元 图生视频
### [Qwen-Image-Layered 发布 - 支持图像分层编辑的生成模型](/zh/news/2025-12-19-qwen-image-layered-release)
2025/12/19
# HunyuanVideo 图生视频GGUF、FP8及ComfyUI Native 工作流完整指南及示例
[腾讯于2025年3月6日正式发布了 HunyuanVideo 图生视频模型](/zh/news/2025-03-06-hunyuanvideo-i2v-launch)，目前模型已开源，你可以在 [HunyuanVideo-I2V](https://huggingface.co/tencent/HunyuanVideo-I2V) 找到模型。
下面是 HunyuanVideo 的整体架构图
目前 ComfyUI 官方已原生支持 HunyuanVideo-I2V 模型，社区作者 [kijai](https://github.com/kijai/) 和 [city96](https://github.com/city96/) 的自定义节点目前已更新支持 HunyuanVideo-I2V 模型。
目前对应模型除了腾讯官方之外，下面是目前 [ComfyUI Wiki](https://comfyui-wiki.com/zh/) 搜索整理到的对应版本
* ComfyUI 官方重新打包版本，无需插件:[Comfy-Org/HunyuanVideo_repackaged](https://huggingface.co/Comfy-Org/HunyuanVideo_repackaged)
* Kijai 版本，需安装[ComfyUI-HunyuanVideoWrapper](https://github.com/kijai/ComfyUI-HunyuanVideoWrapper) :[Kijai/HunyuanVideo_comfy](https://huggingface.co/Kijai/HunyuanVideo_comfy)
* city96 打包版本，需安装[ComfyUI-GGUF](https://github.com/city96/ComfyUI-GGUF):[city96/HunyuanVideo-I2V-gguf](https://huggingface.co/city96/HunyuanVideo-I2V-gguf)
在本文里，我们将会基于这些版本分别提供对应的完整模型安装和工作流示例使用说明。
本文主要讲解图生视频工作流，如果你想要了解腾讯混元文生视频工作流，可以参考[腾讯混元文生视频工作流指南及示例](/zh/tutorial/advanced/hunyuan-text-to-video-workflow-guide-and-example)
## Comfy 官方 HunyuanVideo I2V工作流
相应工作流来自 [ComfyUI 官方文档](https://docs.comfy.org/advanced/hunyuan-video)
请在开始本教程前请参考[如何更新 ComfyUI](/zh/tutorial/basic/how-to-update-comfyui)部分更新你的 ComfyUI 到最新版本，防止出现 **Comfy_Core** 针对 HunyuanVideo 的相关节点缺失
* HunyuanImageToVideo
* TextEncodeHunyuanVideo_ImageToVideo
### 1. HunyuanVideo I2V 工作流文件
下载下面的工作流文件，然后拖入 ComfyUI, 或者使用菜单 `Workflows` -> `Open（ctrl+o）` 打开以加载工作流
**JSON 格式工作流下载**
Comfy 官方版 HunyuanVideo 图生视频工作流
### 2. HunyuanVideo I2V 相关模型下载
以下模型均来自[Comfy-Org/HunyuanVideo_repackaged](https://huggingface.co/Comfy-Org/HunyuanVideo_repackaged)，请下载对应的模型:
* [llava_llama3_vision.safetensors](https://huggingface.co/Comfy-Org/HunyuanVideo_repackaged/resolve/main/split_files/clip_vision/llava_llama3_vision.safetensors?download=true)
* [clip_l.safetensors](https://huggingface.co/Comfy-Org/HunyuanVideo_repackaged/resolve/main/split_files/text_encoders/clip_l.safetensors?download=true)
* [llava_llama3_fp16.safetensors](https://huggingface.co/Comfy-Org/HunyuanVideo_repackaged/resolve/main/split_files/text_encoders/llava_llama3_fp16.safetensors?download=true)
* [llava_llama3_fp8_scaled.safetensors](https://huggingface.co/Comfy-Org/HunyuanVideo_repackaged/resolve/main/split_files/text_encoders/llava_llama3_fp8_scaled.safetensors?download=true)
* [hunyuan_video_vae_bf16.safetensors](https://huggingface.co/Comfy-Org/HunyuanVideo_repackaged/resolve/main/split_files/vae/hunyuan_video_vae_bf16.safetensors?download=true)
* [hunyuan_video_image_to_video_720p_bf16.safetensors](https://huggingface.co/Comfy-Org/HunyuanVideo_repackaged/resolve/main/split_files/diffusion_models/hunyuan_video_image_to_video_720p_bf16.safetensors?download=true)
下载后请按照下面的文件组织，将他们保存到 `ComfyUI/models` 的对应文件夹下
ComfyUI/
├── models/
│ ├── clip_vision/
│ │ └── llava_llama3_vision.safetensors
│ ├── text_encoders/
│ │ ├── clip_l.safetensors
│ │ ├── llava_llama3_fp16.safetensors
│ │ └── llava_llama3_fp8_scaled.safetensors
│ ├── vae/
│ │ └── hunyuan_video_vae_bf16.safetensors
│ └── diffusion_models/
│ └── hunyuan_video_image_to_video_720p_bf16.safetensors
### 3. 输入图片
下载下面的图片作为输入图片
### 按步骤完成对应 HunyuanVideo I2V 工作流节点的检查
参照图片完成对应节点内容的检查，确保工作流正常运行
1. 检查 `DualCLIPLoader` 节点:
* 确保 `clip_name1`: **clip_l.safetensors** 正确加载
* 确保 `clip_name2`: **llava_llama3_vision.safetensors** 正确加载
2. 检查 `Load CLIP Vision` 节点: 确保 **llava_llama3_vision.safetensors** 正确加载
3. 在`Load Image`节点中，上传之前提供的输入图片
4. 检查 `Load VAE` 节点: 确保 **hunyuan_video_vae_bf16.safetensors** 正确加载
5. 检查 `Load Diffusion Model` 节点: 确保 **hunyuan_video_image_to_video_720p_bf16.safetensors** 正确加载
* 如果运行过程中遇到`running out of memory.`错误，可以试着把 `weight_dtype` 设置为 `fp8`类型的
6. 点击 `Run` 按钮，或者使用快捷键 `Ctrl(cmd) + Enter(回车)` 来执行视频生成
## Kijai HunyuanVideoWrapper 版本
### 1. 自定义节点安装
你需要安装以下自定义节点：
* [ComfyUI-VideoHelperSuite](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite)
* [ComfyUI-WanVideoWrapper](https://github.com/kijai/ComfyUI-WanVideoWrapper)
* [ComfyUI-KJNodes](https://github.com/kijai/ComfyUI-KJNodes)
如果你不知道如何安装自定义节点，请参考[ComfyUI 自定义节点安装指南](https://comfyui-wiki.com/en/install/install-custom-nodes)
### 2. 模型下载
* [hunyuan_video_vae_bf16.safetensors](https://huggingface.co/Kijai/HunyuanVideo_comfy/blob/main/hunyuan_video_vae_bf16.safetensors?download=true)
* [hunyuan_video_I2V_fp8_e4m3fn.safetensors](https://huggingface.co/Kijai/HunyuanVideo_comfy/blob/main/hunyuan_video_I2V_fp8_e4m3fn.safetensors?download=true)
下载后请按照下面的文件组织，将他们保存到 `ComfyUI/models` 的对应文件夹下
ComfyUI/
├── models/
│ ├── vae/
│ │ └── hunyuan_video_vae_bf16.safetensors
│ └── diffusion_models/
│ └── hunyuan_video_I2V_fp8_e4m3fn.safetensors
### 3. HunyuanVideo I2V 工作流文件
Kijai 版本 HunyuanVideo 图生视频工作流
### 按步骤完成对应 HunyuanVideo I2V 工作流节点的检查
参照图片完成对应节点内容的检查，确保工作流正常运行
1. 在 `Load Image` 节点中，上传你要用于图生视频的图片
2. 在 `HunyuanVideo VAE Loader` 节点中，确保 `hunyuan_video_vae_bf16.safetensors` 正确加载
3. 在 `HunyuanVideo Model Loader` 节点中，确保 `hunyuan_video_I2V_fp8_e4m3fn.safetensors` 正确加载
4. 修改 `HyVideo I2V Encode` 节点中的 prompt 文本，输入你想要生成的视频描述
5. 点击 `Run` 按钮，或者使用快捷键 `Ctrl(cmd) + Enter(回车)` 来执行视频生成
## city96 GGUF 版本
### 1. 自定义节点安装
你需要安装以下自定义节点：
* [ComfyUI-GGUF](https://github.com/city96/ComfyUI-GGUF)
如果你不知道如何安装自定义节点，请参考[ComfyUI 自定义节点安装指南](https://comfyui-wiki.com/en/install/install-custom-nodes)
### 2. 模型下载
这部分的模型除了 HunyuanVideo 模型之外，基本和 Comfy 官方版本一致, 对应模型请参考本文 Comfy 官方版本部分进行手动下载
你需要访问 [city96/HunyuanVideo-I2V-gguf](https://huggingface.co/city96/HunyuanVideo-I2V-gguf) 下载你需要版本的模型,并保存对应的 gguf 模型文件到 `ComfyUI/models/unet` 文件夹下
ComfyUI/
├── models/
│ ├── clip_vision/
│ │ └── llava_llama3_vision.safetensors
│ ├── text_encoders/
│ │ ├── clip_l.safetensors
│ │ ├── llava_llama3_fp16.safetensors
│ │ └── llava_llama3_fp8_scaled.safetensors
│ ├── vae/
│ │ └── hunyuan_video_vae_bf16.safetensors
│ └── unet/
│ └── hunyuan-video-i2v-720p-Q4_K_M.gguf // 取决于你下载到的版本
### 3. HunyuanVideo I2V 工作流文件
city96 GGUF 版本 HunyuanVideo 图生视频工作流
### 按步骤完成对应 HunyuanVideo I2V 工作流节点的检查
参照图片完成对应节点内容的检查，确保工作流正常运行
1. 检查 `DualCLIPLoader` 节点:
* 确保 `clip_name1`: **clip_l.safetensors** 正确加载
* 确保 `clip_name2`: **llava_llama3_vision.safetensors** 正确加载
2. 检查 `Load CLIP Vision` 节点: 确保 **llava_llama3_vision.safetensors** 正确加载
3. 在`Load Image`节点中，上传之前提供的输入图片
4. 检查 `Load VAE` 节点: 确保 **hunyuan_video_vae_bf16.safetensors** 正确加载
5. 检查 `Load Diffusion Model`** 节点: 确保对应的 HunyuanVideo GGUF 模型 正确加载**
6. 点击 `Run` 按钮，或者使用快捷键 `Ctrl(cmd) + Enter(回车)` 来执行视频生成
主题授权提示：请在后台主题设置-主题授权-激活主题的正版授权，授权购买：RiTheme官网
