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

# Wan2TextToVideoApi - ComfyUI Built-in Node Documentation

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

此节点使用 Wan 2.7 模型根据文本描述生成视频。它会将您的请求发送到外部 API，由该 API 处理提示词并返回视频文件。您可以选择提供音频片段来影响视频的运动和节奏。

## 输入

| 参数                      | 描述                                                                         | 数据类型    | 必填 | 范围                                                            |
| ----------------------- | -------------------------------------------------------------------------- | ------- | -- | ------------------------------------------------------------- |
| `model`                 | 用于视频生成的特定模型。                                                               | COMBO   | 是  | `"wan2.7-t2v"`                                                |
| `model.prompt`          | 描述您希望在视频中呈现的元素和视觉特征。支持英文和中文。                                               | STRING  | 是  | -                                                             |
| `model.negative_prompt` | 描述您希望在生成的视频中避免出现的元素或特征。                                                    | STRING  | 否  | -                                                             |
| `model.resolution`      | 输出视频的分辨率。                                                                  | COMBO   | 是  | `"720P"`<br />`"1080P"`                                       |
| `model.ratio`           | 输出视频的宽高比。                                                                  | COMBO   | 是  | `"16:9"`<br />`"9:16"`<br />`"1:1"`<br />`"4:3"`<br />`"3:4"` |
| `model.duration`        | 视频的时长（秒），默认值为 5。                                                           | INT     | 是  | 2 到 15                                                        |
| `audio`                 | 用于驱动视频生成的音频文件，例如用于唇形同步或动作与节拍匹配。如果未提供，模型将生成匹配的背景音乐或音效。音频时长必须在 1.5 到 60 秒之间。 | AUDIO   | 否  | -                                                             |
| `seed`                  | 用于控制生成随机性的数字，确保结果可复现，默认值为 0。                                               | INT     | 否  | 0 到 2147483647                                                |
| `prompt_extend`         | 启用后，提示词将通过 AI 辅助进行增强，默认值为 True。                                            | BOOLEAN | 否  | -                                                             |
| `watermark`             | 启用后，AI 生成的水印将添加到结果中，默认值为 False。                                            | BOOLEAN | 否  | -                                                             |

**注意：** `audio` 参数为可选。如果提供，其时长必须在 1.5 到 60 秒之间。如果省略，模型将自动生成音频。

## 输出

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

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

***

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