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

# LtxvApiImageToVideo - ComfyUI Built-in Node Documentation

> Complete documentation for the LtxvApiImageToVideo 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/LtxvApiImageToVideo/zh.md)

LTXV 图像转视频节点能够从单张起始图像生成专业质量的视频。它通过外部 API 根据您的文本提示创建视频序列，允许您自定义时长、分辨率和帧率。

## 输入参数

| 参数               | 数据类型    | 必填 | 取值范围                                                                     | 描述                                                         |
| ---------------- | ------- | -- | ------------------------------------------------------------------------ | ---------------------------------------------------------- |
| `image`          | IMAGE   | 是  | -                                                                        | 用于生成视频的首帧图像。                                               |
| `model`          | COMBO   | 是  | `"LTX-2 (Fast)"`<br />`"LTX-2 (Quality)"`                                | 用于视频生成的 AI 模型。"Fast" 模型针对速度进行了优化，而 "Quality" 模型则优先考虑视觉保真度。 |
| `prompt`         | STRING  | 是  | -                                                                        | 用于引导生成视频内容和运动的文本描述。                                        |
| `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"`                      | 生成视频的输出分辨率。                                                |
| `fps`            | COMBO   | 是  | `25`<br />`50`                                                           | 视频的帧率（单位：帧/秒，默认值：25）。                                      |
| `generate_audio` | BOOLEAN | 否  | -                                                                        | 为 True 时，生成的视频将包含与场景匹配的 AI 生成音频（默认值：False）。                |

**重要限制：**

* `image` 输入必须恰好包含一张图像。
* `prompt` 的长度必须在 1 到 10,000 个字符之间。
* 如果您选择的 `duration` 超过 10 秒，则必须使用 **"LTX-2 (Fast)"** 模型、**"1920x1080"** 分辨率和 **25** FPS。此组合是生成长视频的必要条件。

## 输出结果

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