ComfyUI-LTXVideo视频生成工具完全指南：从安装到创作全流程

ComfyUI-LTXVideo是一款强大的ComfyUI扩展工具包，专为LTX-2视频生成模型提供完整节点支持。本指南将帮助你从零开始掌握这款工具的安装配置、模型部署和创意应用，轻松开启AI视频创作之旅。

一、系统环境准备

1.1 硬件配置要求

• 显卡：需配备至少32GB VRAM的CUDA兼容GPU
• 存储：预留100GB以上可用磁盘空间（用于模型文件和缓存）

1.2 软件环境准备

• Python 3.8及以上版本
• 已安装ComfyUI平台
• pip包管理工具

二、两种安装方式详解

2.1 通过ComfyUI Manager安装（推荐新手）

1. 启动ComfyUI并点击Manager按钮（或按Ctrl+M）
2. 选择"Install Custom Nodes"选项
3. 搜索"LTXVideo"并点击安装
4. 等待安装完成后重启ComfyUI

安装成功后，LTXVideo节点会自动出现在节点菜单的"LTXVideo"分类中，首次使用时将自动下载所需模型文件。

2.2 手动安装方法（适合高级用户）

git clone https://gitcode.com/GitHub_Trending/co/ComfyUI-LTXVideo.git custom-nodes/ComfyUI-LTXVideo
cd custom-nodes/ComfyUI-LTXVideo
pip install -r requirements.txt

三、模型文件配置指南

3.1 核心模型检查点

选择以下任一模型下载至COMFYUI_ROOT_FOLDER/models/checkpoints目录：

• ltx-2-19b-dev-fp8.safetensors
• ltx-2-19b-distilled-fp8.safetensors
• ltx-2-19b-dev.safetensors
• ltx-2-19b-distilled.safetensors

3.2 必要组件安装

1. 空间上采样器：下载ltx-2-spatial-upscaler-x2-1.0.safetensors至models/latent_upscale_models
2. 时间上采样器：下载ltx-2-temporal-upscaler-x2-1.0.safetensors至同一目录
3. 蒸馏LoRA：下载ltx-2-19b-distilled-lora-384.safetensors至models/loras
4. Gemma文本编码器：下载全部文件至models/text_encoders/gemma-3-12b-it-qat-q4_0-unquantized

3.3 可选LoRA组件

根据创作需求选择下载至models/loras：

• 边缘检测控制LoRA
• 深度控制LoRA
• 细节增强器LoRA
• 姿态控制LoRA
• 摄像机控制LoRA（推拉、摇摄等效果）

四、快速上手使用教程

4.1 示例工作流程介绍

项目提供多种预设工作流程，位于example_workflows目录下，包含：

• LTX-2_I2V_Distilled_wLora.json（图像到视频蒸馏模型）
• LTX-2_T2V_Full_wLora.json（文本到视频完整模型）
• LTX-2_V2V_Detailer.json（视频到视频细节增强器）

4.2 基础使用步骤

1. 启动ComfyUI并加载所需工作流程
2. 根据节点提示上传输入内容（文本/图像/视频）
3. 调整参数设置（分辨率、帧率、生成长度等）
4. 点击"Queue Prompt"开始生成
5. 在ComfyUI输出目录查看结果

五、低配置设备优化方案

5.1 低VRAM系统设置

1. 使用低VRAM加载器：项目提供专门的低VRAM模型加载器节点，优化32GB VRAM设备的资源分配
2. 调整预留VRAM参数：

   python -m main --reserve-vram 5
   

   根据实际情况调整预留GB数值（建议5-8GB）

5.2 性能优化建议

• 使用蒸馏模型替代完整模型（生成速度提升50%）
• 降低输出分辨率（建议从512x512开始尝试）
• 减少生成帧数（短视频片段优先）

六、核心功能解析

6.1 帧条件控制技术

精确控制视频每一帧的视觉效果，支持关键帧编辑和动态过渡效果，让视频生成更符合创意预期。

6.2 序列条件处理

实现复杂视频序列的操作与编辑，支持多段视频拼接、转场效果添加和镜头语言控制，创作更具叙事性的视频内容。

6.3 智能提示增强

通过先进的NLP技术优化输入提示，提升视频生成质量和内容相关性，即使简单描述也能获得专业级效果。

七、常见问题解决

7.1 模型下载失败

检查网络连接或手动下载模型文件并放置到对应目录，确保文件名与要求完全一致。

7.2 生成过程中断

降低分辨率或减少帧数，检查VRAM使用情况，确保有足够的可用内存。

7.3 节点不显示

重启ComfyUI或重新安装节点，确保所有依赖包已正确安装。

通过本指南，你已掌握ComfyUI-LTXVideo的核心使用方法。无论是文本生成视频、图像转视频还是视频增强，这款工具都能帮助你实现创意愿景。开始探索AI视频创作的无限可能吧！