ComfyUI-LTXVideo 完整指南:3 步装好跑通视频生成,调优技巧一次讲清
【免费下载链接】ComfyUI-LTXVideoLTX-Video Support for ComfyUI项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI-LTXVideo
ComfyUI-LTXVideo 是 ComfyUI 的 LTX 视频生成定制节点合集,覆盖文生视频、图生视频、IC-LoRA 控制与音频生成。这份指南带你用 3 步从安装走到调优,面向已有 ComfyUI 和 NVIDIA GPU 的用户。
两个真实场景,先看它解决什么问题
内容组每天要产出 10 秒的产品短片,又不想搭棚拍摄。把文案写进工作流,LTX 模型直接输出带动效的短视频——这是最常见的文生视频用法。
再进一步:动画师希望生成视频里的运镜严格走"推近→横移"。纯文本提示对镜头轨迹控制不稳,挂上运动跟踪或镜头控制 LoRA 后,轨迹就能被约束住。
这两个场景里,基础模型本身已内置于 ComfyUI 核心,插件补上的是额外节点与配套工作流。装完后,节点会出现在节点菜单的 “LTXVideo” 分类下。
🚀 3 步安装:最快拿到第一个结果
先对照环境要求:
| 组件 | 要求 | 备注 |
|---|---|---|
| Python | 3.8+ | 建议 3.10 |
| ComfyUI | 1.0.0+ | 最新稳定版 |
| LTXV 模型 | v0.9.1+ | ltx-video-2b-v0.9.1.safetensors |
| GPU | CUDA 兼容 | 跑新版 LTX-2.3 22B 系列需 32GB+ 显存、100GB 磁盘 |
第 1 步:拉取代码。进入 ComfyUI 的custom_nodes目录执行:
git clone https://gitcode.com/GitHub_Trending/co/ComfyUI-LTXVideo第 2 步:装依赖。
cd ComfyUI-LTXVideo pip install -r requirements.txtWindows 便携版 ComfyUI 改用这条:
.\python_embeded\python.exe -m pip install -r .\ComfyUI\custom_nodes\ComfyUI-LTXVideo\requirements.txt依赖包含 colour-science、diffusers、kornia、openimageio 等,命令会一并拉取。
第 3 步:放模型与编码器。把ltx-video-2b-v0.9.1.safetensors放进models/checkpoints;文本编码器(负责把你的提示词转成模型能读的向量)通过 ComfyUI Model Manager 安装google_t5-v1_1-xxl_encoderonly。之后加载任一示例工作流,在 ComfyUI Manager 里点 "Install Missing Custom Nodes",缺的 ComfyUI-VideoHelperSuite 等依赖会自动补上。
重启 ComfyUI,工作流跑起来就能出片。核心参数留档:
| 项 | 数值 |
|---|---|
| 模型 | ltx-video-2b-v0.9.1.safetensors(约 2B 参数) |
| 最大分辨率 | 1024x576 |
| 最大帧率 | 30fps |
| 编码器 | t5-v1_1-xxl_encoderonly |
| 上下文长度 | 512 tokens |
示例工作流按模型版本放在example_workflows/下(2.0 / 2.3 / 2.5)。
能力拆解:按目标找功能
文生视频 / 图生视频(T2V / I2V)
- 输入:文本提示词,或一张参考图加 t5 编码特征
- 操作:LTXV 模型采样出帧序列;蒸馏版(为提速蒸馏出的小步数模型)走单阶段出片,完整版保质量
- 产出:视频帧序列,接视频节点保存
帧条件与序列条件控制
- 输入:关键帧图片,或运动方向、速度变化这类时间轴约束
- 操作:指定关键帧内容,或对整段序列施加约束
- 产出:关键帧被锁定的连贯动作视频
提示增强
- 输入:粗糙的短提示词
- 操作:提示增强器节点自动补细节与修饰词,源码在 prompt_enhancer_nodes.py
- 产出:更具体的提示词,视频更贴近本意
IC-LoRA 高级控制(新版 LTX-2 系列)
IC-LoRA 是用深度、边缘、姿态等参考信号引导模型的轻量 LoRA,按目标分:
- 锁定动作:参考视频 + 运动跟踪 LoRA → 输出内容替换但动作一致
- 镜头轨迹:镜头控制 LoRA,覆盖推近/拉远、左右横移、升降、静止
- 提升清晰度:像素空间上采样器按 2×/4× 重绘,合成细节而非插值
- HDR:SDR 视频升 ACEScct HDR,可导出 16/32 位 EXR 序列
- 音频:
LTXVAudioOnlyModel纯文生音频;Dub-It LoRA 做配音/改台词,重生成口型与声音 - 大画幅:Tiled Fusion Sampler 处理 FullHD / 4K / 8K 的 V2V,说明见 tiled_fusion_sampler.md
对应工作流集中在 example_workflows/2.3/ 与 example_workflows/2.5/。
⚙️ 调优对照:卡住了查这张表
| 现象 | 调整方向 | 预期效果 |
|---|---|---|
| 生成太慢 | 降分辨率或帧率;缩短时长;关掉不用的节点 | 单次出片时间下降 |
| 画质差、细节不足 | 加采样步数;补全提示词或走提示增强;换预设 | 细节更稳 |
| 动作飘、轨迹失控 | 加 IC-LoRA 约束(运动跟踪 / 镜头控制) | 动作可控 |
| 分辨率不够 | 两阶段管线 + 空间上采样器(x1.5 / x2) | 成片更清晰 |
| 显存不够 | 低显存加载节点,或启动参数python -m main --reserve-vram 5 | 32GB 显存可跑 |
| 4K/8K 大画幅爆显存 | Tiled Fusion Sampler 分块融合采样 | 大画幅可出片 |
📌 避坑清单
- 模型加载失败:确认文件在
models/checkpoints且名为ltx-video-2b-v0.9.1.safetensors,文件损坏就重新下载。 - 文本编码器缺失:用 ComfyUI Model Manager 装
google_t5-v1_1-xxl_encoderonly。 - 示例工作流报缺节点:ComfyUI Manager 点 "Install Missing Custom Nodes",自动补齐 ComfyUI-VideoHelperSuite 等。
- 便携版装不上:用
.\python_embeded\python.exe那条命令,并确认插件放在custom_nodes下。 - 显存不足 / OOM:启用 low_vram_loaders.py 的低显存加载节点,或加
--reserve-vram 5启动参数。 - 没吃到 GPU:确认 CUDA 兼容显卡,且模型版本不低于 v0.9.1。
进一步看什么
模型清单与版本要求以 README.md 为准,示例工作流在 example_workflows/ 按版本分目录。想弄清某个节点内部怎么工作,从根目录对应源码入手;官方集成文档与社区入口见 README 末尾。
【免费下载链接】ComfyUI-LTXVideoLTX-Video Support for ComfyUI项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI-LTXVideo
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考