WanMoveTrackToVideo - ComfyUI Built-in Node Documentation

Complete documentation for the WanMoveTrackToVideo node in ComfyUI. Learn its inputs, outputs, parameters and usage.

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑

WanMoveTrackToVideo 节点为视频生成准备条件数据和潜在空间数据，并可整合可选的运动跟踪信息。该节点将起始图像序列编码为潜在表示，并能融合来自对象轨迹的位置数据以引导生成视频中的运动。节点输出修改后的正向与负向条件数据，以及一个可供视频模型使用的空潜在张量。

​

输入参数

参数	数据类型	必填	范围	描述
positive	CONDITIONING	是	-	待修改的正向条件输入。
negative	CONDITIONING	是	-	待修改的负向条件输入。
vae	VAE	是	-	用于将起始图像编码到潜在空间的 VAE 模型。
tracks	TRACKS	否	-	包含对象路径的可选运动跟踪数据。
strength	FLOAT	否	0.0 - 100.0	轨迹条件化的强度。（默认值：1.0）
width	INT	否	16 - MAX_RESOLUTION	输出视频的宽度。必须能被 16 整除。（默认值：832）
height	INT	否	16 - MAX_RESOLUTION	输出视频的高度。必须能被 16 整除。（默认值：480）
length	INT	否	1 - MAX_RESOLUTION	视频序列的帧数。（默认值：81）
batch_size	INT	否	1 - 4096	潜在输出的批次大小。（默认值：1）
start_image	IMAGE	是	-	要编码的起始图像或图像序列。
clip_vision_output	CLIPVISIONOUTPUT	否	-	可选的 CLIP 视觉模型输出，用于添加到条件数据中。

注意： strength 参数仅在提供了 tracks 时生效。如果未提供 tracks 或 strength 为 0.0，则不会应用轨迹条件化。start_image 用于为条件化创建潜在图像和掩码；如果未提供，节点仅会透传条件数据并输出一个空的潜在张量。

​

输出参数

输出名称	数据类型	描述
positive	CONDITIONING	修改后的正向条件数据，可能包含 concat_latent_image、concat_mask 和 clip_vision_output。
negative	CONDITIONING	修改后的负向条件数据，可能包含 concat_latent_image、concat_mask 和 clip_vision_output。
latent	LATENT	一个空的潜在张量，其维度由 batch_size、length、height 和 width 输入决定。