ComfyUI-VideoHelperSuite：让图像序列一键变成视频的完整指南-尧图网络科技

ComfyUI-VideoHelperSuite：让图像序列一键变成视频的完整指南

【免费下载链接】ComfyUI-VideoHelperSuiteNodes related to video workflows项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-VideoHelperSuite

这篇文章写给所有被"图像序列转视频"折磨过的ComfyUI玩家。无论你是第一次尝试AnimateDiff，还是想给工作流加上专业的视频输出，VideoHelperSuite都能帮你省下大量时间。本文会用一个真实案例带你走通全流程，并拆解每个节点的实际用途。

一个常见的"翻车"现场

凌晨两点，你用AnimateDiff跑完了一组120帧的动画序列，画面连贯、风格统一，一切都很完美。然后你打开FFmpeg，准备把这堆PNG合成为视频。

接着你开始查参数：-r、-pix_fmt、-crf、-c:v……命令敲到一半，输出尺寸不对，重来；音频对不上，重来；gif导出后浏览器卡死，又是重来。

问题出在哪里？视频处理不该是AI工作流里最麻烦的一环。

ComfyUI-VideoHelperSuite（下文简称VHS）要解决的正是这件事：把视频的读取、切帧、合成、编码全部封装成可视化节点，让你在ComfyUI的节点画布里直接完成"视频进、视频出"的完整闭环。

一句话认识它：为视频工作流而生的节点包

VHS是一组专门服务视频流程的ComfyUI自定义节点，覆盖三条核心链路：

视频 → 图像：把任意视频文件拆成帧序列，供AI模型使用
图像 → 视频：把AI生成的序列帧合成编码为视频文件
中间处理：批处理Latent、批量编解码、预览、音频加载

依赖极其精简，只需opencv-python和imageio-ffmpeg两个库，装起来几乎没有门槛。

实战案例：把AnimateDiff的序列变成8fps动画短片

与其逐个讲参数，不如先跟着一个完整案例走一遍。假设我们刚从AnimateDiff得到了120张动画帧，想输出一段8fps的循环短片，最后附上背景音乐。

第一步：接入帧序列

在节点面板的Video Helper Suite分类下，拖出Load Image Sequence节点：

在directory里填入存放帧的文件夹路径
将image_load_cap设为 120，只加载前120张
select_every_nth保持 1，不做跳帧

如果输入的是现成视频而不是图片文件夹，就改用Load Video节点，把force_rate设为 8——AnimateDiff 的标准工作帧率。值得说明的是，VHS还内置了 Mochi、LTXV、Hunyuan、Cosmos、Wan 等模型的推荐加载参数，选中对应预设即可自动匹配帧率与尺寸。

第二步：用批量VAE节点转换Latent

处理视频帧时，直接对整批Latent做VAE编解码容易爆显存。VHS提供的VAE Encode Bacted / VAE Decode Bacted节点（源码位于videohelpersuite/batched_nodes.py）会把序列按per_batch分批送入VAE，默认每批16帧，显著降低峰值显存占用。

第三步：合成输出视频

拖入Video Combine节点，它是整个套件的"出口"：

frame_rate：设为 8，与输入帧率保持一致
pingpong：开启后视频会正放再倒放，自动形成一个无缝循环，适合动画演示
format：在下拉列表里选video/h264-mp4
filename_prefix：支持%date:yyyy-MM-ddThh:mm:ss%这类时间戳占位符

如果想让画面首尾完全衔接，还可以先在上游对帧序列做一次头尾裁剪，配合pingpong效果更佳。

第四步：挂上音频

Load Audio节点提供了独立的音频加载能力，seek_seconds参数可以指定音频的起始时间。把它的输出接到 Video Combine 的audio输入上，合成时音频会被自动混入输出文件。

核心能力拆解：四个模块逐个看

1. 输入节点：怎么把素材"喂"进来

VHS提供了Load Video与Load Image Sequence两套输入节点，参数逻辑几乎一致，区别只在读取的是视频还是文件夹。

几个关键参数值得记住：

参数	作用	典型用法
`force_rate`	强制目标帧率，通过丢帧/补帧实现	匹配AnimateDiff的8fps
`force_size`	快速调整尺寸，可只指定宽或高	预处理到512×512
`frame_load_cap`	最大返回帧数，即最大batch	控制单次显存占用
`skip_first_frames`	跳过开头N帧	配合cap分段处理长视频
`select_every_nth`	每N帧取一帧	处理GIF时常用

每条输入节点都提供 Upload（上传）和 Path（外部路径）两种变体，后者可直接读取ComfyUI目录外的文件。

2. 输出节点：Video Combine 的参数心法

Video Combine 是合成节点，除了上文的常用参数，还有三个容易被忽略的设置：

crf：画质与体积的平衡点。数值越低画质越高、文件越大；视觉无损大约在20附近，动画作品建议 18–22
pix_fmt：yuv420p10le支持10bit色深，画质更好，但部分设备播放不了
save_metadata：把工作流写入视频元数据，之后把视频拖回ComfyUI即可还原工作流，和图片拖拽一样方便

节点还会返回VHS_FILENAMES，包含输出文件路径列表，方便后续节点引用。

3. 序列工具节点：Latent 的"剪辑台"

VHS为Latent和图像各提供了一套批处理工具（videohelpersuite/image_latent_nodes.py）：

Split Batch：按索引把序列一分为二，常用于把长序列拆成"前一半训练、后一半测试"
Merge Batch：把两组序列合并，尺寸不一致时可自动缩放对齐
Select Every Nth：抽帧采样，每N个保留第一个
Duplicate Batch：复制序列，用于循环素材扩充
Get Count：读取序列数量，可作为条件分支的判断依据

4. 格式系统：JSON 定义你的每一种输出

VHS把视频格式做成了"可插拔"的JSON配置，存放在项目的video_formats/目录下。内置了12种预设：h264-mp4、h265-mp4、av1-webm、ProRes、ffv1-mkv、gif、gifski、8bit/16bit PNG序列，以及多款NVENC硬件编码格式。

以 av1-webm 为例，配置结构大致如下：

{ "main_pass": ["-n", "-c:v", "libsvtav1", "-pix_fmt", "yuv420p10le", "-crf", 23], "audio_pass": ["-c:a", "libopus"], "extension": "webm" }

main_pass是传给ffmpeg的编码参数，audio_pass是音频编码参数，extension决定容器格式。熟悉ffmpeg的用户完全可以照葫芦画瓢，在video_formats/下新增自己的格式文件，并在节点里用字段声明把参数暴露成界面控件。

三步上手：从零到第一条视频

安装

git clone https://gitcode.com/gh_mirrors/co/ComfyUI-VideoHelperSuite

把克隆下来的文件夹放入ComfyUI的custom_nodes目录，安装依赖后重启ComfyUI：

pip install -r requirements.txt

依赖只有两个：opencv-python和imageio-ffmpeg。如果本机已有可用的ffmpeg，VHS会自动优先调用系统版本。

首次运行的最小工作流

添加Load Image Sequence，选中你存放帧序列的文件夹
添加Video Combine，将前者输出的IMAGE连入后者的images输入
format选择video/h264-mp4，点击执行
到ComfyUI的output目录查看生成的MP4

整个过程不到两分钟，这就是VHS最核心的价值：输入输出节点一接，中间全部交给你的AI模型处理。

进阶技巧：让VHS更好用的四个设置

① 开启高级预览

点击 Queue Prompt 旁的设置齿轮，勾选VHS Advanced Previews。开启后，Load Video 节点的预览会实时反映节点上的参数设置——比如skip_first_frames和frame_load_cap改了多少，预览就切到对应片段，选帧定位一目了然。

它的附加收益也很实在：远程运行服务器时能大幅减少传输带宽；大尺寸视频会按界面分辨率压缩，浏览器性能明显改善；原本无法在浏览器播放的格式也能预览了。代价是预览画面有延迟、画质略低，但右键"Open preview"随时能看原始文件。

② 利用预览的右键菜单

所有带预览的节点都支持右键操作：Open preview（放大查看）、Save preview（保存当前帧）、Pause preview（暂停播放，处理超大视频时更流畅）、Hide preview（隐藏预览省内存）、Sync preview（让多个预览同步重启，便于并排对比）。

③ 用分段加载处理超长视频

单个视频太长、一次加载爆显存时，不必手动裁剪文件。记下当前的frame_load_cap和skip_first_frames，每跑完一轮就把skip_first_frames加上frame_load_cap，就能分批把整段视频处理完，且帧率经过force_rate归一化，段与段之间不会错位。