> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Flux3ImageToVideoNode - ComfyUI Built-in Node Documentation

> Flux 3 Image to Video 使用 FLUX 3 将 1 到 10 张图像动画化。

Flux 3 Image to Video 使用 FLUX 3 将 1 到 10 张图像动画化。每张图像都会成为片段中的一帧：一张图像用于开场，两张图像时从第一张过渡到第二张，更多图像则均匀分布在片段中，或固定在您选择的时间点上。

## 输入

| 参数                 | 描述                                                                                           | 数据类型           | 必需 | 范围                                               |
| ------------------ | -------------------------------------------------------------------------------------------- | -------------- | -- | ------------------------------------------------ |
| `prompt`           | 场景应如何移动和发声；提示词在生成前会被解释并扩展。必须至少包含一个字符。                                                        | STRING         | 是  | 多行文本（默认：空）                                       |
| `keyframes`        | 按播放顺序排列的 1 到 10 张图像。每张图像至少为 256x256 像素。可增长输入：按 `image_1`、`image_2` 等顺序连接图像。                  | IMAGE          | 是  | 1 到 10 张图像                                       |
| `placement`        | “spread across the clip” 让 FLUX 3 自行放置图像（一张作为开场，两张分别作为片段的开始和结束）；“at times” 会将每张图像固定在您选择的某一秒。 | DYNAMIC\_COMBO | 是  | `"spread across the clip"`（默认）<br />`"at times"` |
| `times`            | 每个图像对应一个以秒为单位的时间，用逗号分隔且递增，例如 “0, 2.5, 5”。仅当 `placement` 为 “at times” 时显示；每个关键帧图像都需要一个时间。     | STRING         | 否  | 逗号分隔的秒数（默认："0"）                                  |
| `aspect_ratio`     | 输出宽高比。“auto” 会根据提示词和输入自动选择一个。                                                                | COMBO          | 是  | `"auto"`（默认）<br />其他可用宽高比                        |
| `duration`         | 片段时长（秒）。“auto” 会根据内容自动调整时长。                                                                  | COMBO          | 是  | `"auto"`（默认）<br />其他可用时长                         |
| `resolution`       | 输出分辨率。                                                                                       | COMBO          | 是  | `"720p"`（默认）<br />`"1080p"`                      |
| `generate_audio`   | 生成同步音频（环境声、语音、音效）。关闭时生成的视频没有音轨。                                                              | BOOLEAN        | 是  | true / false（默认：true）                            |
| `safety_tolerance` | 审核容忍度，0 为最严格。无论此处设置为多少，发送图像或视频的请求上限均为 2。                                                     | INT            | 是  | 0 到 4（默认：2，高级设置）                                 |
| `seed`             | 用于决定节点是否应重新运行的种子；FLUX 3 会自行选择种子，因此无论此值如何，实际结果都是不确定的。                                         | INT            | 是  | 0 到 4294967295（默认：42，control-after-generate）     |

注意：`keyframes` 必须至少包含一张图像；如果未连接任何图像，节点将报错。每个关键帧图像必须至少为 256x256 像素，且其宽高比不能比 64:1 更极端。

当 `placement` 为 “spread across the clip” 且连接了 3 个或更多关键帧时，`duration` 必须设置为显式值，不能为 “auto”；否则节点将报错。

当 `placement` 为 “at times” 时，`times` 必须为每个图像提供一个以秒为单位的时间。这些时间必须递增、不能为负，且最后一个时间不能超出片段的末尾（当 `duration` 为 “auto” 时最多为 20 秒）。

由于此节点会发送图像，无论您设置的值是多少，`safety_tolerance` 的上限均为 2。

## 输出

| 输出名称    | 描述                                 | 数据类型  |
| ------- | ---------------------------------- | ----- |
| `video` | 根据所选宽高比、时长、分辨率和音频设置，由关键帧图像生成的视频片段。 | VIDEO |

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

***

**Source fingerprint (SHA-256):** `1c49838dfa13adc2ed70a51094f0dd860df7207970b8dceab6bb273653d7161c`
