> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ByteDance2FirstLastFrameNode - ComfyUI Built-in Node Documentation

> 此节点使用 ByteDance Seedance 模型，根据必需的首帧图像和可选的尾帧图像生成视频。

此节点使用 ByteDance Seedance 模型，根据必需的首帧图像和可选的尾帧图像生成视频。你使用文本提示词描述视频；首帧引导视频开头，尾帧引导视频结尾。它支持 Seedance 2.5 和 Seedance 2.0 系列（Seedance 2.0、Seedance 2.0 Fast 和 Seedance 2.0 Mini）。选择 `Seedance 2.5 Draft` 模型会改为渲染快速的 480p 预览；将生成的 `draft_task_id` 连接到 ByteDance Seedance 2.5 Draft to Final Video 节点，以渲染 1080p 最终视频。

## 输入

### 通用输入

| 参数 | 描述 | 数据类型 | 必需 | 范围 |
| - | - | - | - | - |
| `模型` | Seedance 2.5 用于最新模型、最长 30 秒的视频和 mp4 输出；Seedance 2.5 Draft 用于快速 480p 预览，其 `draft_task_id` 输出可在 ByteDance Seedance 2.5 Draft to Final Video 节点中渲染 1080p 最终视频；Seedance 2.0 用于最高质量和 4k；Fast 用于速度优化；Mini 用于最快、成本最低的生成。选择模型后，下方会显示特定于该模型的输入。 | DYNAMIC\_COMBO | 是 | `"Seedance 2.5"`<br />`"Seedance 2.5 Draft"`<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.5 Draft 输入

当选择 `Seedance 2.5 Draft` 时，这些输入会出现。参数集与上面的 Seedance 2.5 相同，区别是 `resolution` 仅提供 `"480p"`（默认 `"480p"`）。

### 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` 输入是必需的，且不能为空。
* 每次运行都会以 `draft_task_id` 返回其任务 ID，但只有 `Seedance 2.5 Draft` 运行产生的 ID 才能由 ByteDance Seedance 2.5 Draft to Final Video 节点渲染。使用任何其他模型时，该输出必须保持未连接，否则运行会失败。
* 使用 `Seedance 2.5` 时，输出宽高比始终为 `adaptive`，并遵循首帧自身的宽高比，因此不会显示 `ratio` 输入。
* 使用 Seedance 2.0 系列模型和本地帧图像时，图像会在生成前被中心裁剪并调整为目标输出分辨率和比例。当 `ratio` 为 `adaptive` 时，会使用与输入图像最接近的受支持比例。
* 本地帧图像会验证其是否具有受支持的宽高比和尺寸；过大的图像会被缩小。

## 输出

| 输出名称 | 描述 | 数据类型 |
| - | - | - |
| `output` | 生成的视频。 | VIDEO |
| `draft_task_id` | 运行返回的任务 ID。只有 `Seedance 2.5 Draft` 运行会生成可由 ByteDance Seedance 2.5 Draft to Final Video 节点渲染的草稿；使用任何其他模型时，该输出必须保持未连接，否则运行会失败。 | STRING |

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

***

**Source fingerprint (SHA-256):** `363f1baac1685c2dada0e64a0b339f6ab2671161dccb002eb81f6b4f0d0aa243`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.