Load Video (Path) 🎥🅥🅗🅢 (LoadVideoPath) - ComfyUI-VideoHelperSuite

Load Video (Path) 🎥🅥🅗🅢 节点提供了丰富的视频处理选项，允许用户对加载过程进行精细控制。

Load Video (Path) 节点是 Video Helper Suite 工具包中的核心组件，用于从本地文件系统或网络 URL 加载视频文件。其主要功能是将视频文件解码为一系列连续的图像帧（IMAGE），以便在 ComfyUI 的工作流中进行后续的图像处理、分析或生成任务。

节点功能

此节点提供了丰富的视频处理选项，允许用户对加载过程进行精细控制。例如，用户可以限制加载的帧数、跳过开头的部分帧、按间隔抽取帧，甚至可以强制指定输出帧的尺寸和帧率。这使得它非常适用于处理大型视频文件或需要特定预处理步骤的场景。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`meta_batch`	VHS_BatchManager	否	-	-	：连接批处理管理器，用于在批处理模式下协调多个视频的加载。
`vae`	VAE	否	-	-	：连接一个 VAE 模型。若提供，则直接输出视频帧的潜空间表示（LATENT），否则输出图像（IMAGE）。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`video`	STRING	是	-	-	：指定要加载的视频文件路径或网络 URL。支持常见视频格式（如 .mp4, .mov, .avi 等）。
`force_rate`	COMBO	是	0	0 - 60 (步长: 1)	：强制设定输出帧序列的帧率（FPS）。范围为 0 到 60，步长为 1。设为 0 则使用视频原始帧率。
`custom_width`	INT	是	0	0 - DIMMAX	：强制设定输出图像的宽度。范围为 0 到 DIMMAX，设为 0 则保持视频原始宽度。
`custom_height`	INT	是	0	0 - DIMMAX	：强制设定输出图像的高度。范围为 0 到 DIMMAX，设为 0 则保持视频原始高度。
`frame_load_cap`	INT	是	0	0 - BIGMAX (步长: 1)	：限制最多加载的帧数。范围为 0 到 BIGMAX，步长为 1。设为 0 表示加载所有帧。
`skip_first_frames`	INT	是	0	0 - BIGMAX (步长: 1)	：跳过视频开头指定数量的帧后再开始加载。范围为 0 到 BIGMAX，步长为 1。
`select_every_nth`	INT	是	1	1 - BIGMAX (步长: 1)	：每隔 N 帧加载一帧，用于降采样。范围为 1 到 BIGMAX，步长为 1。

节点的一个关键特性是支持与 VAE（变分自编码器）连接。当提供了 VAE 模型时，节点会直接将视频帧编码为潜空间表示（LATENT）输出，从而跳过显式的图像解码步骤，可以显著提升处理流程的效率，特别适用于需要将视频输入到基于潜空间的生成模型（如 Stable Diffusion）的工作流中。

此外，节点还会输出视频的元信息（如原始尺寸、帧率）、分离出的音频轨道以及实际加载的帧总数。这些输出为后续节点提供了必要的上下文信息，方便构建复杂的视频处理管线。