ComfyUI-LTXVideo 2.5 官方文件清单
LTX-2.5 ComfyUI 模型文件清单
官方 LTX-2.5 示例工作流引用的每一个文件 —— 它在 Hugging Face 的位置、应放进 ComfyUI/models/ 的哪个子目录、有多大,以及有哪些低显存变体。
模型权重版权归 Lightricks 所有,按 LTX-2 Community License 分发。所有链接均指向官方 Hugging Face 仓库 —— 我们不镜像权重。
72.7 GB
最小文件集,bf16
41.3 GB
最小文件集,INT8 变体
6 个目录
位于 ComfyUI/models/ 下
32 GB+ 显存
Lightricks 官方要求
快速开始(最小文件集)
推荐的文生 / 图生视频两阶段工作流只需要这 6 个文件。本页其余文件都是可选的。
ltx-2.5-22b-distilled-transformer-bf16.safetensorsComfyUI/models/diffusion_models/42.0 GBHugging Facegemma4-12b-with-proj-ltx-2.5-bf16.safetensorsComfyUI/models/text_encoders/26.3 GBHugging Faceltx-2.5-video-vae-bf16.safetensorsComfyUI/models/vae/1.5 GBHugging Faceltx-2.5-video-vae-conv-bf16.safetensorsComfyUI/models/vae/1.5 GBHugging Faceltx-2.5-audio-vae-bf16.safetensorsComfyUI/models/vae/0.40 GBHugging Faceltx-2.5-latent-spatial-upscaler-x2-bf16-1.0.safetensorsComfyUI/models/latent_upscale_models/1.0 GBHugging Face
下载总量72.7 GB
不必手动下载:在 ComfyUI 里打开工作流,点击 Workflow Overview → Download all,ComfyUI 会把每个文件放进正确的子目录。
LTX-2.5 全部文件
按 ComfyUI/models/ 子目录分组。低显存变体列在它所替代的模型下方。
扩散模型
| 文件 | 目录 | 大小 | 用途 | 链接 |
|---|---|---|---|---|
ltx-2.5-22b-distilled-transformer-bf16.safetensors | ComfyUI/models/diffusion_models/ | 42.0 GB | LTX-2.5 22B 蒸馏版主模型 —— 所有示例工作流都用它。采样步数少,面向快速迭代。 | Hugging Face |
↳ ltx-2.5-22b-distilled-transformer-comfy-int8-convrot.safetensors低显存变体 | ComfyUI/models/diffusion_models/ | 21.5 GB | INT8 —— 体积约减半,24 GB 显卡的常用选择。 | Hugging Face |
↳ ltx-2.5-22b-distilled-transformer-nvfp4.safetensors低显存变体 | ComfyUI/models/diffusion_models/ | 18.7 GB | NVFP4 —— 体积最小;需要支持 FP4 的 NVIDIA 显卡(Blackwell 架构)。 | Hugging Face |
ltx-2.5-22b-dev-transformer-bf16.safetensors | ComfyUI/models/diffusion_models/ | 42.0 GB | 完整版(非蒸馏)LTX-2.5 模型。采样步数更多、画质上限更高;蒸馏示例工作流不使用它。 | Hugging Face |
↳ ltx-2.5-22b-dev-transformer-comfy-int8-convrot.safetensors低显存变体 | ComfyUI/models/diffusion_models/ | 21.5 GB | 完整版模型的 INT8 变体。 | Hugging Face |
文本编码器
| 文件 | 目录 | 大小 | 用途 | 链接 |
|---|---|---|---|---|
gemma4-12b-with-proj-ltx-2.5-bf16.safetensors | ComfyUI/models/text_encoders/ | 26.3 GB | 带 LTX-2.5 投影层的 Gemma 4 12B 文本编码器 —— 把提示词转成条件向量。所有工作流必需。 | Hugging Face |
↳ gemma4-12b-with-proj-ltx-2.5-comfy-int8-convrot.safetensors低显存变体 | ComfyUI/models/text_encoders/ | 15.4 GB | INT8 文本编码器 —— 磁盘和内存各省约 11 GB。 | Hugging Face |
VAE
| 文件 | 目录 | 大小 | 用途 | 链接 |
|---|---|---|---|---|
ltx-2.5-video-vae-bf16.safetensors | ComfyUI/models/vae/ | 1.5 GB | 视频 VAE —— 编码输入帧、把生成的潜变量解码为像素。 | Hugging Face |
ltx-2.5-video-vae-conv-bf16.safetensors | ComfyUI/models/vae/ | 1.5 GB | 示例工作流解码路径引用的卷积版视频 VAE。 | Hugging Face |
ltx-2.5-audio-vae-bf16.safetensors | ComfyUI/models/vae/ | 0.40 GB | 音频 VAE —— 解码 LTX-2.5 与视频同步生成的音轨。 | Hugging Face |
潜空间上采样器
| 文件 | 目录 | 大小 | 用途 | 链接 |
|---|---|---|---|---|
ltx-2.5-latent-spatial-upscaler-x2-bf16-1.0.safetensors | ComfyUI/models/latent_upscale_models/ | 1.0 GB | 2 倍潜空间空间上采样器 —— 所有两阶段工作流的第二阶段。 | Hugging Face |
ltx-2.5-latent-temporal-upscaler-x2-bf16-1.0.safetensors | ComfyUI/models/latent_upscale_models/ | 0.30 GB | 2 倍时间上采样器 —— 在潜空间把帧率翻倍。可选;默认示例工作流未接入。 | Hugging Face |
LoRA
| 文件 | 目录 | 大小 | 用途 | 链接 |
|---|---|---|---|---|
ltx-2.5-22b-distilled-lora-450-bf16.safetensors | ComfyUI/models/loras/ | 8.9 GB | 让完整版模型少步数运行的蒸馏 LoRA。使用蒸馏版主模型时不需要。 | Hugging Face |
ltx-2.3-22b-ic-lora-union-control-ref0.5.safetensors | ComfyUI/models/loras/ | — | IC-LoRA:从参考视频提取深度 / 边缘 / 姿态做控制。 | Hugging Face |
ltx-2.3-22b-ic-lora-motion-track-control-ref0.5.safetensors | ComfyUI/models/loras/ | — | IC-LoRA:跟随在首帧上绘制的运动轨迹。 | Hugging Face |
ltx-2.3-22b-ic-lora-ingredients-0.9.safetensors | ComfyUI/models/loras/ | — | IC-LoRA:从角色 / 道具 / 场景参考图表生成。 | Hugging Face |
ltx-2.3-22b-ic-lora-in-outpainting-0.9.safetensors | ComfyUI/models/loras/ | — | IC-LoRA:对参考视频做区域重绘(inpaint)或画幅外扩(outpaint)。 | Hugging Face |
ltx-2.3-22b-ic-lora-deblur-0.9.safetensors | ComfyUI/models/loras/ | — | V2V 工作流自带的 IC-LoRA 示例(去模糊)。可换成任意身份 / 风格 / 编辑类 LoRA。 | Hugging Face |
IC-LoRA 是 LTX-2.3 时期的权重:官方 2.5 控制类工作流把它们叠加在 2.5 蒸馏版主模型上使用,这正是 Lightricks 官方的发布方式。
模型补丁
| 文件 | 目录 | 大小 | 用途 | 链接 |
|---|---|---|---|---|
ltx-2.5-duration-head-bf16.safetensors | ComfyUI/models/model_patches/ | 0.05 GB | 音频类工作流使用的小型时长预测头。 | Hugging Face |
我的显卡该用哪个变体?
按显卡选择主模型与文本编码器的版本,只下载需要的文件。
| 显存 | 示例显卡 | 主模型 | 文本编码器 | 结论 | 建议 |
|---|---|---|---|---|---|
| 16 GB 以下 | RTX 3060 12G、4060、4070、多数笔记本 | nvfp4 | int8 | 建议在线 | 22B 主模型即使 NVFP4 也有 18.7 GB。大概率爆显存或极度依赖卸载。建议直接在线生成 —— 同一个 LTX-2 模型,零配置。 |
| 16 GB | RTX 4060 Ti 16G、4080、5070 Ti、A4000 | nvfp4 | int8 | 临界 | 处于临界。用 NVFP4 主模型(Blackwell)或 INT8 + 激进卸载(--reserve-vram)、INT8 文本编码器、单阶段工作流和低分辨率。会很慢,且不是每个工作流都能跑。 |
| 24 GB | RTX 3090、4090、A5000 | int8 | int8 | 可用 | 可用:INT8 主模型 + INT8 文本编码器 + 低显存加载节点。两阶段工作流能跑;解码 tile 保持小尺寸。bf16 文件留给 32 GB+ 的显卡。 |
| 32 GB | RTX 5090、V100 32G | bf16 | int8 | 宽裕 | Lightricks 官方的最低要求。bf16 主模型配低显存加载节点可以放下;INT8 文本编码器能腾出空间给更大的解码 tile 和更长的片段。 |
| 48 GB+ | RTX 6000 Ada、A6000、H100 | bf16 | bf16 | 宽裕 | 全部 bf16、无需卸载。调大解码 tile(见每个工作流内的 Decode 说明)可以明显提速。 |
Lightricks 官方要求 32 GB+ 显存。上表中更低的档位是保守的社区经验,并非官方支持矩阵。
显存不到 24 GB?在线使用同一个 LTX-2 模型
4K 输出 + 同步音频,无需下载任何文件,注册即送免费积分。
目录结构
子目录名必须完全一致 —— ComfyUI 的加载节点只会列出对应目录里的文件。
ComfyUI/
└── models/
├── diffusion_models/
│ └── ltx-2.5-22b-distilled-transformer-bf16.safetensors
├── text_encoders/
│ └── gemma4-12b-with-proj-ltx-2.5-bf16.safetensors
├── vae/
│ └── ltx-2.5-video-vae-bf16.safetensors
├── latent_upscale_models/
│ └── ltx-2.5-latent-spatial-upscaler-x2-bf16-1.0.safetensors
├── loras/
│ └── ltx-2.3-22b-ic-lora-union-control-ref0.5.safetensors
└── model_patches/
└── ltx-2.5-duration-head-bf16.safetensors旧版 LTX-2.3 文件
仅用于工作流页面列出的 LTX-2.3 工作流。新环境建议直接从 2.5 开始。 查看 2.3 工作流
| 文件 | 目录 | 大小 | 用途 | 链接 |
|---|---|---|---|---|
ltx-2.3-22b-distilled-1.1.safetensors | ComfyUI/models/checkpoints/ | — | LTX-2.3 蒸馏版一体化 checkpoint。 | Hugging Face |
ltx-2.3-22b-dev.safetensors | ComfyUI/models/checkpoints/ | — | LTX-2.3 完整版 checkpoint。 | Hugging Face |
ltx-2.3-spatial-upscaler-x2-1.1.safetensors | ComfyUI/models/latent_upscale_models/ | — | 2.3 两阶段工作流的 2 倍空间上采样器。 | Hugging Face |
ltx-2.3-temporal-upscaler-x2-1.0.safetensors | ComfyUI/models/latent_upscale_models/ | — | 2.3 的 2 倍时间上采样器。 | Hugging Face |
ltx-2.3-22b-distilled-lora-384-1.1.safetensors | ComfyUI/models/loras/ | — | 2.3 完整版 checkpoint 的蒸馏 LoRA。 | Hugging Face |
gemma-3-12b-it-qat-q4_0-unquantized (whole repo) | ComfyUI/models/text_encoders/gemma-3-12b-it-qat-q4_0-unquantized/ | — | LTX-2.3 工作流使用的 Gemma 3 12B 文本编码器。 | Hugging Face |