> ## 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.

# Wan2ImageToVideoApi - ComfyUI Built-in Node Documentation

> Complete documentation for the Wan2ImageToVideoApi node in ComfyUI. Learn its inputs, outputs, parameters and usage.

Wan 2.7 图像转视频节点可根据首帧图像生成视频。您可以选择提供末帧图像来创建两者之间的过渡，或提供音频文件来引导视频的运动和节奏。该节点使用 AI 模型根据您的文本描述对场景进行动画处理。

## 输入

| 参数                      | 描述                                                                     | 数据类型    | 是否必填 | 取值范围                    |
| ----------------------- | ---------------------------------------------------------------------- | ------- | ---- | ----------------------- |
| `model`                 | 用于视频生成的 AI 模型。                                                         | COMBO   | 是    | `"wan2.7-i2v"`          |
| `model.prompt`          | 描述您希望在视频中呈现的元素和视觉特征的文本。支持中文和英文。                                        | STRING  | 是    | -                       |
| `model.negative_prompt` | 描述您希望模型避免出现的元素或特征的文本。                                                  | STRING  | 是    | -                       |
| `model.resolution`      | 输出视频的分辨率。                                                              | COMBO   | 是    | `"720P"`<br />`"1080P"` |
| `model.duration`        | 生成视频的时长（秒），默认值为 5。                                                     | INT     | 是    | 2 至 15                  |
| `first_frame`           | 用作视频首帧的图像。输出视频的宽高比由此图像决定。                                              | IMAGE   | 是    | -                       |
| `last_frame`            | 可选，用作视频末帧的图像。提供后，模型将生成从首帧过渡到末帧的视频。                                     | IMAGE   | 否    | -                       |
| `audio`                 | 可选，用于驱动视频生成的音频文件，适用于唇形同步或节拍匹配运动。时长必须在 2 到 30 秒之间。若未提供，模型将生成匹配的背景音乐或音效。 | AUDIO   | 否    | -                       |
| `seed`                  | 控制生成随机性的种子值，默认值为 0。                                                    | INT     | 是    | 0 至 2147483647          |
| `prompt_extend`         | 启用后，节点将使用 AI 辅助增强您的文本提示（默认：True）。此为高级设置。                               | BOOLEAN | 是    | -                       |
| `watermark`             | 启用后，将在最终视频中添加 AI 生成的水印（默认：False）。此为高级设置。                               | BOOLEAN | 是    | -                       |

**注意：** `audio` 输入有时长限制。若提供，音频文件时长必须在 2 到 30 秒之间。

## 输出

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

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

***

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