WanReferenceVideoApi - ComfyUI Built-in Node Documentation

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

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

Wan Reference to Video 节点利用一个或多个输入参考视频的视觉外观和语音，结合文本提示词，生成新的视频内容。它在保持与参考素材中角色一致性的同时，根据您的描述创造新的内容。

​

输入参数

参数	数据类型	必填	取值范围	描述
model	COMBO	是	"wan2.6-r2v"	用于视频生成的具体 AI 模型。
prompt	STRING	是	-	对新视频中元素和视觉特征的描述。支持英文和中文。使用如 character1、character2 等标识符来指代参考视频中的角色。
negative_prompt	STRING	否	-	描述希望在生成视频中避免出现的元素或特征。
reference_videos	AUTOGROW	是	-	用作角色外观和语音参考的视频输入列表。您必须提供至少一个视频。每个视频可以分配一个名称，如 character1、character2 或 character3。
size	COMBO	是	"720p: 1:1 (960x960)" "720p: 16:9 (1280x720)" "720p: 9:16 (720x1280)" "720p: 4:3 (1088x832)" "720p: 3:4 (832x1088)" "1080p: 1:1 (1440x1440)" "1080p: 16:9 (1920x1080)" "1080p: 9:16 (1080x1920)" "1080p: 4:3 (1632x1248)" "1080p: 3:4 (1248x1632)"	输出视频的分辨率和宽高比。
duration	INT	是	5 到 10	生成视频的长度，单位为秒。该值必须是 5 的倍数（默认值：5）。
seed	INT	否	0 到 2147483647	用于获得可重现结果的随机种子值。值为 0 时将生成一个随机种子。
shot_type	COMBO	是	"single" "multi"	指定生成的视频是单个连续镜头，还是包含多个带有剪辑的镜头。
watermark	BOOLEAN	否	-	启用后，会在最终视频上添加一个 AI 生成的水印（默认值：False）。

约束条件：

• reference_videos 中提供的每个视频时长必须在 2 到 30 秒之间。
• duration 参数仅限于特定值（5 或 10 秒）。

​

输出参数

输出名称	数据类型	描述
output	VIDEO	新生成的视频文件。