ComfyUI-EmptyHunyuanLatent 插件完整使用教程

1. 插件简介

GitHub原地址：https://github.com/ShmuelRonen/ComfyUI-EmptyHunyuanLatent

这个插件就像是一个专门为混元（Hunyuan）模型量身定制的"空白画布制造机"。想象一下，你要在纸上画画，首先需要一张白纸对吧？这个插件就是帮你准备这张"白纸"的工具，只不过这张"白纸"是专门给混元AI模型用的。

它能给我们带来什么效果？ - 为混元图片生成模型准备专用的"空白画布" - 为混元视频生成模型准备专用的"空白画布" - 自动处理各种常见的图片尺寸和比例（比如手机竖屏、电脑横屏等） - 让你的混元模型工作得更稳定、更高效

简单来说，这个插件就是混元模型的"贴心助手"，专门负责准备合适的工作空间。

2. 如何安装

方法一：通过 ComfyUI Manager 安装（推荐）

1. 打开你的 ComfyUI
2. 点击 Manager 按钮（管理器）
3. 在搜索框输入 "EmptyHunyuanLatent"
4. 找到后点击安装
5. 重启 ComfyUI

方法二：手动安装

1. 打开命令行或终端
2. 切换到你的 ComfyUI 安装目录下的 custom_nodes 文件夹
3. 运行命令：git clone https://github.com/ShmuelRonen/ComfyUI-EmptyHunyuanLatent.git
4. 重启 ComfyUI

3. 节点逐一解析

3.1 EmptyHunyuanLatentForImage 节点是干嘛的？

这个节点就像是一个"图片专用的空白画布制造机"。它专门为混元图片生成模型准备合适的工作空间。就好比你要用特定的画笔画画，就需要特定质地的纸张一样，混元模型也需要特定格式的"画布"才能发挥最好的效果。

这个节点会根据你选择的尺寸和比例，自动创建一个空白的数据容器，让混元模型可以在上面"作画"。

3.2 EmptyHunyuanLatentForImage 参数详解

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | resolution | resolution | 多种预设选项 | 根据需要选择 | 这就像选择画布的大小和形状，比如选择正方形、长方形、手机竖屏还是电脑横屏的比例 | 控制生成图像的分辨率和宽高比，所有尺寸都会自动调整为16的倍数以确保兼容性 | 如果你想生成手机壁纸，选择 576x1024 (9:16)；如果想生成电脑壁纸，选择 1024x576 (16:9) | | batch_size | batch_size | 1-999 | 1 | 这就像告诉机器"我一次要准备几张画布"，数字越大，一次准备的画布越多 | 控制批处理大小，即同时生成的图像数量 | 如果你想一次生成3张不同的图片，就设置为3；如果只想生成1张，就设置为1 |

3.3 EmptyHunyuanLatentForVideo 节点是干嘛的？

这个节点就像是一个"视频专用的空白画布制造机"。它和上面的图片节点很像，但是专门为混元视频生成模型服务。就好比拍电影需要准备胶卷一样，这个节点为混元视频模型准备"数字胶卷"。

它不仅要考虑画面的大小和比例，还要考虑视频的长度（也就是帧数）。帧数就像是翻页动画的页数，页数越多，动画越长。

3.4 EmptyHunyuanLatentForVideo 参数详解

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | resolution | resolution | 多种预设选项 | 根据需要选择 | 这就像选择视频画面的大小和形状，比如选择正方形、长方形、手机竖屏还是电脑横屏的比例 | 控制生成视频的分辨率和宽高比，所有尺寸都会自动调整为16的倍数以确保兼容性 | 如果你想生成抖音短视频，选择 576x1024 (9:16)；如果想生成横屏视频，选择 1024x576 (16:9) | | frames | frames | 1-256 | 16 | 这就像告诉机器"我要拍多少张照片来做成动画"，数字越大，视频越长 | 控制视频的帧数，即视频的长度 | 如果你想生成一个短动画，可以设置为16帧；如果想要更长的视频，可以设置为64帧或更多 | | batch_size | batch_size | 1-999 | 1 | 这就像告诉机器"我一次要准备几套视频胶卷"，数字越大，一次准备的胶卷越多 | 控制批处理大小，即同时生成的视频数量 | 如果你想一次生成2个不同的视频，就设置为2；如果只想生成1个，就设置为1 |

4. 支持的分辨率选项详解

这个插件支持很多常见的分辨率，就像去照相馆选择照片尺寸一样：

竖屏格式（适合手机、短视频）： - 576x1024 (9:16) - 标准手机竖屏比例 - 704x1408 (1:2) - 超长竖屏 - 768x1344 (4:7) - 宽一点的竖屏

正方形格式（适合朋友圈、头像）： - 1024x1024 (1:1) - 标准正方形

横屏格式（适合电脑、电视）： - 1024x576 (16:9) - 标准宽屏比例 - 1344x704 (16:9) - 高清宽屏 - 1408x704 (2:1) - 超宽屏

5. 使用技巧和建议

5.1 选择合适的分辨率

• 做短视频内容：选择 576x1024 或 768x1344 这样的竖屏比例
• 做电脑壁纸：选择 1024x576 或 1344x704 这样的横屏比例
• 做头像或方形图片：选择 1024x1024 正方形

5.2 帧数设置建议

• 短动画或GIF：16-32帧就够了
• 中等长度动画：64-96帧
• 长视频：128-256帧（注意：帧数越多，生成时间越长，显存需求越大）

5.3 批处理数量建议

• 显存较小：batch_size 设为1，稳定第一
• 显存充足：可以设为2-4，提高效率
• 显存很大：可以设更高，但要注意别超过你的硬件极限

5.4 连接其他节点

• 这两个节点的输出都是 "LATENT" 类型，可以直接连接到 KSampler 等采样器节点
• 在工作流中，通常放在最开始的位置，作为整个生成流程的起点

6. 常见问题解答

Q1: 为什么我找不到这些节点？

A: 可能是安装不完整或者需要重启ComfyUI。先确认插件已经正确安装，然后重启ComfyUI。节点位置： - 图片节点：右键菜单 → latent → EmptyHunyuanLatentForImage - 视频节点：右键菜单 → latent/video → EmptyHunyuanLatentForVideo

Q2: 选择什么分辨率最好？

A: 这取决于你的需求： - 想要清晰度高：选择数字大的分辨率（比如1408x704） - 想要生成速度快：选择数字小的分辨率（比如576x1024） - 想要省显存：选择数字小的分辨率

Q3: 帧数设置多少合适？

A: 根据你的设备性能和需求： - 新手或显存小：建议16帧 - 性能一般：32-64帧 - 性能很好：可以尝试128帧以上

Q4: batch_size 设置多大合适？

A: 建议从1开始： - 如果生成没问题，可以逐步增加到2、3、4... - 如果出现显存不足错误，就减少数量 - 记住：batch_size 越大，显存需求越大

Q5: 为什么我生成的图片/视频分辨率和设置的不一样？

A: 这是正常的！插件会自动调整分辨率确保是16的倍数，这样混元模型才能正常工作。实际输出的分辨率可能会有轻微调整。

7. 工作流程示例

简单的图片生成流程： 1. 添加 EmptyHunyuanLatentForImage 节点 2. 选择合适的分辨率（比如 1024x1024） 3. 连接到 KSampler 节点 4. 添加混元模型加载器 5. 设置提示词 6. 连接到图片输出节点

简单的视频生成流程： 1. 添加 EmptyHunyuanLatentForVideo 节点 2. 选择合适的分辨率和帧数 3. 连接到视频采样器节点 4. 添加混元视频模型加载器 5. 设置提示词 6. 连接到视频输出节点

8. 注意事项

• 这个插件专门为混元模型设计，使用其他模型可能不会有最佳效果
• 显存不足时，优先降低batch_size，再考虑降低分辨率或帧数
• 生成视频时，帧数越多，生成时间越长，要有耐心
• 如果遇到错误，首先检查是否是显存不足，然后检查ComfyUI和插件版本是否最新

记住，这个插件就像是一个贴心的助手，专门为混元模型准备工作空间。选择合适的参数，让它为你的创作提供最好的支持！