> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.
# ByteDance2ReferenceNodeV2 - ComfyUI Built-in Node Documentation
> ByteDance Seedance 2.5 Reference to Video generates, edits, or extends videos using ByteDance Seedance models (Seedance 2.5, 2.0, 2.0 Fast, and 2.0 Mini) guided by a text prompt an
## 输入
### 通用输入
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| ---- | ----------------------------------------------------------------------------------------------------------------------------- | -------------- | -- | ------------------------------------------------------------------------------------ |
| `模型` | 模型选择器。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 | 是 | 多行文本 |
| `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 | 是 | 多行文本 |
| `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 | 是 | 多行文本 |
| `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 个插槽（Seedance 2.0 系列）
1..30 个插槽（Seedance 2.5） |
| `reference_videos` | 可增长插槽：连接 1..N 个参考视频。数量限制因模型而异（参见模型部分）。每个视频长度必须至少为 1.8 秒，并且必须符合所选模型和分辨率的像素限制。 | VIDEO | 否 | 1..3 个插槽（Seedance 2.0 系列）
1..10 个插槽（Seedance 2.5） |
| `reference_audios` | 可增长插槽：连接 1..N 个参考音频轨道。数量限制因模型而异（参见模型部分）。每个音频长度必须至少为 1.8 秒。 | AUDIO | 否 | 1..3 个插槽（Seedance 2.0 系列）
1..10 个插槽（Seedance 2.5） |
| `reference_assets` | 可增长插槽：连接 1..N 个已上传到 Seedance 虚拟库的媒体资产 ID 字符串。每个资产必须处于 Active 状态。您可以在提示中使用 `asset1` 或 `asset 1` 等令牌引用资产；节点会将它们替换为资产的位置标签（例如“Image 2”或“Video 1”）。 | STRING | 否 | 1..9 个插槽（Seedance 2.0 系列）
1..30 个插槽（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 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/zh.md)
***
**Source fingerprint (SHA-256):** `3a6bba12e719204ba5dba9d7d5f2b4c5285ed68974ee015b6e4a7892a1cf0933`