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

# LtxvApiTextToVideo - ComfyUI Built-in Node Documentation

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

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

## 概述

LTXV Text To Video 节点能够根据文本描述生成专业质量的视频。它通过连接外部 API 来创建可自定义时长、分辨率和帧率的视频。您还可以选择为视频添加 AI 生成的音频。

## 输入

| 参数               | 数据类型    | 必填 | 范围                                                                       | 描述                                       |
| ---------------- | ------- | -- | ------------------------------------------------------------------------ | ---------------------------------------- |
| `model`          | COMBO   | 是  | `"LTX-2 (Fast)"`<br />`"LTX-2 (Quality)"`<br />`"LTX-2 (Turbo)"`         | 用于视频生成的 AI 模型。可用模型映射自源代码中的 `MODELS_MAP`。 |
| `prompt`         | STRING  | 是  | -                                                                        | AI 将用于生成视频的文本描述。此字段支持多行文本。               |
| `duration`       | COMBO   | 是  | `6`<br />`8`<br />`10`<br />`12`<br />`14`<br />`16`<br />`18`<br />`20` | 生成视频的时长，单位为秒（默认：8）。                      |
| `resolution`     | COMBO   | 是  | `"1920x1080"`<br />`"2560x1440"`<br />`"3840x2160"`                      | 输出视频的像素尺寸（宽 x 高）。                        |
| `fps`            | COMBO   | 是  | `25`<br />`50`                                                           | 视频的帧率，单位为每秒帧数（默认：25）。                    |
| `generate_audio` | BOOLEAN | 否  | -                                                                        | 启用后，生成的视频将包含与场景匹配的 AI 生成音频（默认：False）。    |

**重要限制：**

* `prompt` 的长度必须在 1 到 10,000 个字符之间。
* 如果您选择的 `duration` 大于 10 秒，则必须同时使用 `"LTX-2 (Fast)"` 模型、`"1920x1080"` 分辨率和 `25` 的 `fps`。此组合是生成长视频的必要条件。

## 输出

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