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

# LTXVDurationPredictor - ComfyUI Built-in Node Documentation

> 此节点使用 LTX 2.4 时长预测头（duration head）根据提示词预测镜头的自然时长。

此节点使用 LTX 2.4 时长预测头（duration head）根据提示词预测镜头的自然时长。它使用提供的帧率和最小/最大时长限制，将预测时长转换为符合 VAE 帧网格的帧数。

## 输入

| 参数              | 说明                                                   | 数据类型         | 是否必填 | 范围          |
| --------------- | ---------------------------------------------------- | ------------ | ---- | ----------- |
| `model`         | 用于预处理文本嵌入并运行时长预测头的模型。                                | MODEL        | 是    | N/A         |
| `positive`      | 为时长预测提供提示词文本嵌入和元数据的 conditioning。                    | CONDITIONING | 是    | N/A         |
| `duration_head` | 通过 ModelPatchLoader 加载的 LTX 2.4 时长预测头。必须是 LTX 时长预测头。 | MODEL\_PATCH | 是    | N/A         |
| `frame_rate`    | 帧率（帧/秒），用于将秒转换为帧（默认值：24.0）。                          | FLOAT        | 是    | 1.0 到 120.0 |
| `min_seconds`   | 将预测结果转换为帧数时使用的最小时长（秒）（默认值：1.0）。                      | FLOAT        | 是    | 0.5 到 120.0 |
| `max_seconds`   | 将预测结果转换为帧数时使用的最大时长（秒）（默认值：20.0）。                     | FLOAT        | 是    | 0.5 到 120.0 |

注意：`duration_head` 输入必须是使用 ModelPatchLoader 加载的 LTX 2.4 时长预测头。如果连接的模型补丁不是 LTX 时长预测头，该节点将引发 ValueError。

## 输出

| 输出名          | 说明                              | 数据类型  |
| ------------ | ------------------------------- | ----- |
| `num_frames` | 预测时长转换后的帧数，并对齐到 VAE 的 8k+1 帧网格。 | INT   |
| `seconds`    | 原始（未裁剪）预测时长。这是对齐到帧网格之前的值。       | FLOAT |

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

***

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