ByteDance2ReferenceNodeV2 - ComfyUI Built-in Node Documentation

ByteDance Seedance 2.5 Reference to Video 节点可在文本提示词以及可选的参考图像、视频、音频或之前上传的素材库资源的引导下，使用 ByteDance Seedance 模型（Seedance 2.5、2.0、2.0 Fast 和 2.0 Mini）生成、编辑或延长视频。

ByteDance Seedance 2.5 Reference to Video 节点可在文本提示词以及可选的参考图像、视频、音频或之前上传的素材库资源的引导下，使用 ByteDance Seedance 模型（Seedance 2.5、2.0、2.0 Fast 和 2.0 Mini）生成、编辑或延长视频。该节点会上传参考素材，提交生成任务，等待完成，并返回生成的视频文件。

​

输入

​

通用输入

参数	描述	数据类型	必填	范围
模型	模型选择器。Seedance 2.5 为最新模型，视频最长 30 秒，输出 mp4/mov；Seedance 2.0 提供最高质量和 4k；Fast 用于速度优化；Mini 用于最快、成本最低的生成。选择模型会更改下方显示的输入控件。	DYNAMIC_COMBO	是	”Seedance 2.5" "Seedance 2.0" "Seedance 2.0 Fast" "Seedance 2.0 Mini”
种子	种子控制节点是否需要重新运行；无论种子如何，结果都是非确定性的。默认值：0。	INT	是	0 到 2147483647
水印	是否为视频添加水印。默认值：False。高级设置。	BOOLEAN	是	true false

​

Seedance 2.5 输入

当 model 设置为 “Seedance 2.5” 时，会显示这些输入。

参数	描述	数据类型	必填	范围
prompt	用于视频生成的文本提示词。将台词放在双引号中以引导生成的对话。默认值：空字符串。	STRING	是	Multiline text
resolution	输出视频的分辨率。默认值：720p。	COMBO	是	”480p" "720p" "1080p”
ratio	输出视频的宽高比。默认值：16:9。	COMBO	是	”16:9" "4:3" "1:1" "3:4" "9:16" "21:9" "adaptive”
duration	输出视频的时长（秒，4-30）。默认值：5。	INT	是	4 到 30
generate_audio	为输出视频启用音频生成。默认值：True。	BOOLEAN	是	true false
task_type	如何处理参考媒体。除 auto 外的每个值都会在提交任务时进行验证，因此不匹配的设置会在生成开始前失败。 auto：模型根据提示词和输入推断任务，与其理解冲突的设置只会在生成开始后失败。 reference：在参考图像、视频和音频的引导下生成新视频。 edit：更改已连接的参考视频（添加、删除、替换）；输出会保留源片段自身的长度和宽高比，duration 和 ratio 控件将被忽略。 extend：向前或向后延续已连接的参考视频；提示词应写明 “extend forward”、“extend backward” 或 “continue”，宽高比跟随源片段，输出只包含按你设置的时长新生成的那段内容，不包含源片段。默认值：auto。	COMBO	是	”auto" "reference" "edit" "extend”
output_format	输出视频的容器格式。默认值：mp4。	COMBO	是	”mp4”

​

Seedance 2.0 输入

当 model 设置为 “Seedance 2.0” 时，会显示这些输入。

参数	描述	数据类型	必填	范围
prompt	用于视频生成的文本提示词。默认值：空字符串。	STRING	是	Multiline text
resolution	输出视频的分辨率。	COMBO	是	”480p" "720p" "1080p" "4k”
ratio	输出视频的宽高比。默认值：adaptive。	COMBO	是	”16:9" "4:3" "1:1" "3:4" "9:16" "21:9" "adaptive”
duration	输出视频的时长（秒，4-15）。默认值：7。	INT	是	4 到 15
generate_audio	为输出视频启用音频生成。默认值：True。	BOOLEAN	是	true false

​

Seedance 2.0 Fast 和 Seedance 2.0 Mini 输入

当 model 设置为 “Seedance 2.0 Fast” 或 “Seedance 2.0 Mini” 时，会显示这些输入。这两个模型共享相同的输入集。

参数	描述	数据类型	必填	范围
prompt	用于视频生成的文本提示词。默认值：空字符串。	STRING	是	Multiline text
resolution	输出视频的分辨率。	COMBO	是	”480p" "720p”
ratio	输出视频的宽高比。默认值：adaptive。	COMBO	是	”16:9" "4:3" "1:1" "3:4" "9:16" "21:9" "adaptive”
duration	输出视频的时长（秒，4-15）。默认值：7。	INT	是	4 到 15
generate_audio	为输出视频启用音频生成。默认值：True。	BOOLEAN	是	true false

​

参考输入

这些可扩展的参考槽位适用于所有模型。每个模型支持的最大槽位数量不同：Seedance 2.5 最多支持 30 张图像、10 个视频、10 个音频和 30 个素材；Seedance 2.0、2.0 Fast 和 2.0 Mini 最多支持 9 张图像、3 个视频、3 个音频和 9 个素材。

参数	描述	数据类型	必填	范围
reference_images	可扩展槽位：连接 1..N 张参考图像以引导输出。数量限制因模型而异（见各模型部分）。图像会进行宽高比验证（0.4 到 2.5），并自动缩小，使最长边不超过 6000 像素。	IMAGE	否	1..9 slots (Seedance 2.0 family) 1..30 slots (Seedance 2.5)
reference_videos	可扩展槽位：连接 1..N 个参考视频。数量限制因模型而异（见各模型部分）。每个视频必须至少 1.8 秒长，并且必须符合所选模型和分辨率的像素限制。	VIDEO	否	1..3 slots (Seedance 2.0 family) 1..10 slots (Seedance 2.5)
reference_audios	可扩展槽位：连接 1..N 条参考音频轨道。数量限制因模型而异（见各模型部分）。每个音频必须至少 1.8 秒长。	AUDIO	否	1..3 slots (Seedance 2.0 family) 1..10 slots (Seedance 2.5)
reference_assets	可扩展槽位：连接 1..N 个已上传到 Seedance 虚拟素材库的媒体素材 ID 字符串。每个素材必须处于 Active 状态。你可以在提示词中使用诸如 asset1 或 asset 1 的标记来引用素材；节点会将它们替换为素材的位置标签（例如 “Image 2” 或 “Video 1”）。	STRING	否	1..9 slots (Seedance 2.0 family) 1..30 slots (Seedance 2.5)
auto_downscale	自动缩小超过所选分辨率下模型像素预算的参考视频。保持宽高比；已在限制内的视频不受影响。默认值：True。	BOOLEAN	否	true false
auto_upscale	自动放大低于所选分辨率下模型最小像素数的参考视频。保持宽高比；已达到最小值的视频不受影响。注意：放大低分辨率源不会增加真实细节，并可能产生质量较低的生成结果。默认值：False。高级设置。	BOOLEAN	否	true false

注意： 运行该节点至少需要一张参考图像、一个参考视频或一个参考素材（Seedance 2.5 还接受仅音频参考）。参考视频和音频各自必须至少 1.8 秒长，且所有参考视频的总时长（以及单独计算的所有参考音频总时长）不得超过所选模型的最大总秒数。参考图像的宽高比必须大致在 2:5 到 5:2（0.4 到 2.5）之间，至少为 300x300 像素，并会自动缩小，使最长边不超过 6000 像素。task_type 的 “edit” 和 “extend” 选项仅适用于 Seedance 2.5，且二者都要求至少有一个参考视频；使用 “edit” 时，输出会保留源片段自身的长度和宽高比，duration 和 ratio 控件将被忽略；使用 “extend” 时，输出只包含按你设置的时长新生成的那段内容。引用的素材必须处于 Active 状态，否则任务会失败。

​

输出

输出名称	描述	数据类型
video	生成任务完成后从提供方下载的生成视频。启用音频生成时包含音频。	VIDEO

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

---

Source fingerprint (SHA-256): 3a6bba12e719204ba5dba9d7d5f2b4c5285ed68974ee015b6e4a7892a1cf0933