> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ByteDance2FirstLastFrameNode - ComfyUI Built-in Node Documentation

> 此节点使用字节跳动 Seedance 模型，从必需的首帧图像和可选的末帧图像生成视频。

此节点使用字节跳动 Seedance 模型，从必需的首帧图像和可选的末帧图像生成视频。您可以通过文本提示描述视频；首帧引导视频的开头，末帧引导视频的结尾。它支持 Seedance 2.5 以及 Seedance 2.0 系列（Seedance 2.0、Seedance 2.0 Fast 和 Seedance 2.0 Mini）。

## 输入

### 通用输入

| 参数                     | 描述                                                                                                                             | 数据类型           | 是否必需 | 范围                                                                                           |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------ | -------------- | ---- | -------------------------------------------------------------------------------------------- |
| `模型`                   | `Seedance 2.5` 为最新模型，支持最长 30 秒视频以及 mp4/mov 输出；`Seedance 2.0` 提供最高质量和 4K；`Fast` 用于速度优化；`Mini` 用于最快、成本最低的生成。选择模型后，下方会显示该模型对应的输入。 | DYNAMIC\_COMBO | 是    | `"Seedance 2.5"`<br />`"Seedance 2.0"`<br />`"Seedance 2.0 Fast"`<br />`"Seedance 2.0 Mini"` |
| `首帧图像`                 | 视频的首帧图像。                                                                                                                       | IMAGE          | 否    | -                                                                                            |
| `末帧图像`                 | 视频的末帧图像。                                                                                                                       | IMAGE          | 否    | -                                                                                            |
| `first_frame_asset_id` | 用作首帧的 Seedance asset\_id。与 `first_frame` 图像输入互斥。默认为空字符串。                                                                       | STRING         | 否    | -                                                                                            |
| `last_frame_asset_id`  | 用作末帧的 Seedance asset\_id。与 `last_frame` 图像输入互斥。默认为空字符串。                                                                        | STRING         | 否    | -                                                                                            |
| `种子`                   | Seed 控制节点是否应重新运行；无论 seed 为何值，结果都是非确定性的。默认为 0。                                                                                  | INT            | 是    | 0 到 2147483647                                                                               |
| `水印`                   | 是否在视频中添加水印。默认为 False。                                                                                                          | BOOLEAN        | 是    | False<br />True                                                                              |

### Seedance 2.5 输入

选择 `Seedance 2.5` 时，显示以下输入。

| 参数               | 描述                              | 数据类型    | 是否必需 | 范围                                    |
| ---------------- | ------------------------------- | ------- | ---- | ------------------------------------- |
| `prompt`         | 用于视频生成的文本提示。将台词放在双引号中，以引导生成的对话。 | STRING  | 是    | -                                     |
| `resolution`     | 输出视频的分辨率。默认为 720p。              | COMBO   | 是    | `"480p"`<br />`"720p"`<br />`"1080p"` |
| `duration`       | 输出视频的时长（秒）（4-30）。默认为 5。         | INT     | 是    | 4 到 30                                |
| `generate_audio` | 为输出视频启用音频生成。默认为 True。           | BOOLEAN | 是    | False<br />True                       |
| `output_format`  | 输出视频的容器格式。默认为 mp4。              | COMBO   | 是    | `"mp4"`                               |

### Seedance 2.0 输入

选择 `Seedance 2.0` 时，显示以下输入。

| 参数               | 描述                                           | 数据类型    | 是否必需 | 范围                                                                                            |
| ---------------- | -------------------------------------------- | ------- | ---- | --------------------------------------------------------------------------------------------- |
| `prompt`         | 用于视频生成的文本提示。                                 | STRING  | 是    | -                                                                                             |
| `resolution`     | 输出视频的分辨率。                                    | COMBO   | 是    | `"480p"`<br />`"720p"`<br />`"1080p"`<br />`"4k"`                                             |
| `ratio`          | 输出视频的宽高比。默认为 `adaptive`，即使用与输入帧宽高比最接近的受支持比例。 | COMBO   | 是    | `"16:9"`<br />`"4:3"`<br />`"1:1"`<br />`"3:4"`<br />`"9:16"`<br />`"21:9"`<br />`"adaptive"` |
| `duration`       | 输出视频的时长（秒）（4-15）。默认为 7。                      | INT     | 是    | 4 到 15                                                                                        |
| `generate_audio` | 为输出视频启用音频生成。默认为 True。                        | BOOLEAN | 是    | False<br />True                                                                               |

### Seedance 2.0 Fast 和 Seedance 2.0 Mini 输入

由 `Seedance 2.0 Fast` 和 `Seedance 2.0 Mini` 共用。

| 参数               | 描述                                           | 数据类型    | 是否必需 | 范围                                                                                            |
| ---------------- | -------------------------------------------- | ------- | ---- | --------------------------------------------------------------------------------------------- |
| `prompt`         | 用于视频生成的文本提示。                                 | STRING  | 是    | -                                                                                             |
| `resolution`     | 输出视频的分辨率。                                    | COMBO   | 是    | `"480p"`<br />`"720p"`                                                                        |
| `ratio`          | 输出视频的宽高比。默认为 `adaptive`，即使用与输入帧宽高比最接近的受支持比例。 | COMBO   | 是    | `"16:9"`<br />`"4:3"`<br />`"1:1"`<br />`"3:4"`<br />`"9:16"`<br />`"21:9"`<br />`"adaptive"` |
| `duration`       | 输出视频的时长（秒）（4-15）。默认为 7。                      | INT     | 是    | 4 到 15                                                                                        |
| `generate_audio` | 为输出视频启用音频生成。默认为 True。                        | BOOLEAN | 是    | False<br />True                                                                               |

**参数约束**

* 您必须提供首帧，可以是 `first_frame` 图像，也可以是 `first_frame_asset_id`。同时提供两者会引发错误；两者都不提供也会引发错误。
* `last_frame` 和 `last_frame_asset_id` 输入是可选的，但不能为同一帧同时提供两者。
* Asset ID 必须引用现有且处于活动状态的 Seedance Image 资源。
* `prompt` 输入为必填项，且不能为空。
* 使用 `Seedance 2.5` 时，输出宽高比始终为自适应，并遵循首帧自身的宽高比，因此不显示 `ratio` 输入。
* 使用 Seedance 2.0 系列模型和本地帧图像时，图像会在生成前进行中心裁剪并调整大小为目标输出分辨率和宽高比。当 `ratio` 为 `adaptive` 时，使用与输入图像最接近的受支持比例。
* 本地帧图像会经过受支持宽高比和尺寸的验证；过大的图像会被缩小。

## 输出

| 输出名称     | 描述     | 数据类型  |
| -------- | ------ | ----- |
| `output` | 生成的视频。 | VIDEO |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2FirstLastFrameNode/zh.md)

***

**Source fingerprint (SHA-256):** `bc2eb5f43c935986ad870703cfbc92dd99a53d6f0ac91cf0cad46bee33ff2cc0`
