Complete LTX-2.5 ComfyUI Workflow Guide: T2V, I2V, FLF2V & Multi-Shot Setup
Step-by-step tutorial on running Lightricks' LTX-2.5 natively in ComfyUI — covering template loading, Hugging Face gated access, model directory setup, Diffusion Fidelity Rendering, and multi-shot prompting.
Complete LTX-2.5 ComfyUI Workflow Guide: T2V, I2V, FLF2V & Multi-Shot Setup
LTX-2.5 from Lightricks represents a major breakthrough in open-weights video generation. Designed as a DiT-based world model, LTX-2.5 delivers synchronized high-fidelity video and 32 kHz stereo audio in a single pass. With novel features like Diffusion Fidelity Rendering (DFR), native multi-shot scene continuity, a fine-tuned Gemma 4 12B text backbone, and a built-in Prompt Enhancer, LTX-2.5 offers studio-grade production capabilities directly on local hardware.
With official native support available in ComfyUI, setting up LTX-2.5 is straightforward. In this step-by-step guide, we walk you through everything: resolving Hugging Face gated repository access, organizing split model checkpoints, mastering the three official workflows (T2V, I2V, FLF2V), writing effective multi-shot prompts, and tuning performance for 16GB+ VRAM GPUs.
1. Introduction & Key Capabilities
Before setting up your canvas, let me introduce what makes LTX-2.5 unique for local ComfyUI creators:
Key Upgrades in LTX-2.5
- Diffusion Video Decoder (DFR): Replaces static VAE decoding with a generative diffusion reconstruction pass that sharpens faces, skin pores, clothing weave, and text legibility.
- Native Multi-Shot Generation: Maintains character identity, lighting, background geometry, and voice timbre across explicit camera cuts without needing external editing software.
- Gemma 4 12B Vision-Language Encoder: Replaces legacy T5/CLIP text encoders to deliver high prompt adherence for complex multi-subject interactions.
- Integrated Prompt Enhancer: Automatically expands short user prompts into rich cinematic scenes, camera movements, and audio cues.
- 8-Step Distilled Inference: Offers ultra-fast generation at fixed CFG=1.0 while matching the visual quality of 50-step diffusion runs.
2. Getting Started – Loading Official Templates & HF Gated Access
ComfyUI provides official native workflow templates for LTX-2.5. However, there is one critical step you must complete first regarding model licensing.
The official LTX-2.5 weights repository (Lightricks/LTX-2.5) is gated on Hugging Face under a community license (free for creators under \$10M ARR). Before ComfyUI can automatically download model weights:
- Log into your Hugging Face Account and accept the LTX-2.5 license terms.
- Generate a User Access Token (Read Permission) under Settings → Access Tokens.
- Add your token to ComfyUI via
comfyui-manageror by setting the environment variableHF_TOKEN=your_token_here. Alternatively, download model files manually as shown in Section 3.
Loading Templates in ComfyUI
Update ComfyUI to the latest version to ensure all core LTX-2.5 nodes (LTXVideoSampler, LTXVideoPipeline) are registered.
Click the Templates tab in the ComfyUI menu bar and navigate to Video → LTX-2.5.
Choose one of the three pre-built official workflows:
Text-to-Video (T2V)
Generates video and synchronized audio from text prompts with optional 2x spatial upscaling.
Image-to-Video (I2V)
Uses a reference image as the initial keyframe while driving motion and camera via prompt.
First & Last Frame (FLF2V)
Interpolates smooth motion and audio bridging two keyframe images with identical aspect ratios.
3. Model Files & Directory Structure
If you prefer to download checkpoints manually or set up low-VRAM quantized versions, place files according to the following directory layout:
📄 ltx-2.5-audio-vae.safetensors (32 kHz Stereo Audio VAE)
Component Roles & Usage Table
| File Component | Used In Workflows | Description & VRAM Tip |
|---|---|---|
Distilled Transformer (int8-convrot) |
All Workflows | 8-step inference checkpoint. The INT8-convrot version reduces VRAM footprint significantly. |
| Gemma 4 12B Text Encoder | All Workflows | Language understanding model. Can be offloaded to system CPU RAM on 16GB GPUs. |
Diffusion Video Decoder (diff-vae) |
T2V, I2V, FLF2V | Secondary diffusion pass reconstructing faces, fine skin details, and readable text. |
| 2x Spatial Upscaler | T2V & I2V (Two-Stage) | Elevates 768p base latents to higher resolutions before final VAE decoding. |
4. Step-by-Step Workflow Walkthroughs
Workflow A: Text-to-Video (T2V) Mode
In T2V mode, LTX-2.5 generates complete cinematic scenes with synchronized audio purely from a text prompt.
- Load T2V Template: Open
Templates -> Video -> LTX-2.5 -> Text-to-Video. - Set Prompt: Enter your prompt into the text box. Check Enable Prompt Enhancer to automatically expand camera instructions.
- Configure Sampler:
- Steps: Set to 8.
- CFG: Keep locked at 1.0 for the distilled model.
- Resolution & Duration: Set initial resolution to
1216 x 704(or 16:9 equivalent). Select target clip duration (e.g. 97 frames ≈ 4 seconds at 24 FPS). - Run Queue: Execute prompt generation.
Workflow B: Image-to-Video (I2V) Mode
I2V mode uses an input image as the initial keyframe while generating forward motion, camera movement, and audio.
[image_latent conditioning]
- Load I2V Template: Open
Templates -> Video -> LTX-2.5 -> Image-to-Video. - Upload Reference Image: Load your image into the
Load Imagenode. - Write Motion Prompt: Describe what happens next in the scene rather than re-describing what is already visible in the static image:
- Example Prompt:
"The woman turns her head toward the window as a thunderstorm breaks out. Camera slowly zooms in. AUDIO: Heavy rain, thunder rumble."
- Example Prompt:
- Run Queue: Execute prompt generation.
Workflow C: First & Last Frame (FLF2V) Keyframe Interpolation
FLF2V interpolates fluid motion, camera transition, and audio between two static keyframe images.
[start_frame & end_frame]
- Load FLF2V Template: Open
Templates -> Video -> LTX-2.5 -> First & Last Frame. - Match Aspect Ratios: Ensure Image 1 and Image 2 share identical dimensions and aspect ratios (e.g. both 1280x720).
- Describe Transition: Write a prompt explaining the physical movement connecting the two images:
- Example Prompt:
"A samurai pulls his sword from its sheath in a swift arc. Camera pans right. AUDIO: Metallic blade unsheathing sound, wind whistling."
- Example Prompt:
- Run Queue: Execute keyframe interpolation.
5. Prompting Best Practices & Multi-Shot Syntax
LTX-2.5 understands detailed cinematic scene descriptions and native multi-shot camera cuts.
Good vs. Weak Prompt Comparison
"A man drinking coffee inside a café."
Lacks camera tracking details, lighting cues, temporal pacing, and audio instruction.
"Cinematic warm indoor light, 35mm film. SHOT 1: Wide shot of a man taking a sip of espresso near a sunlit window. CUT TO: Close-up of his face as he smiles gently. AUDIO: Coffee cup clinking on saucer, soft acoustic guitar background music, café chatter."
Explicitly specifies shot framing, multi-cut transition (`CUT TO`), facial expressions, and acoustic ambient layers.
6. Resolution, Duration & VRAM Optimization Tips
Recommended Starting Resolutions
| Aspect Ratio | Standard Base Resolution | Upscaled Target | Recommended Use Case |
|---|---|---|---|
| 16:9 Widescreen | 1216 x 704 | 2432 x 1408 (2x) | Cinematic landscapes, film scenes. |
| 9:16 Vertical | 704 x 1216 | 1408 x 2432 (2x) | Social media content & vertical video. |
| 1:1 Square | 896 x 896 | 1792 x 1792 (2x) | Instagram / product showcases. |
VRAM Tuning Guide
- 16 GB VRAM GPUs: Use the distilled
ltx-2.5-transformer-distilled-int8-convrot.safetensorsmodel. Enable CPU offloading for the Gemma 4 12B text encoder inside your loader node. - 24 GB VRAM GPUs: Run full FP8 distilled models with the Diffusion Video Decoder (
diff-vae) enabled for maximum face and micro-texture detail.
7. Common Issues & Troubleshooting
🔑 Hugging Face 401 Unauthorized Error
If model auto-download fails with a 401 status code, verify that your Hugging Face account has accepted the license on Lightricks/LTX-2.5 and that your HF_TOKEN is set inside ComfyUI.
📐 FLF2V Aspect Ratio Mismatch Crash
When using First & Last Frame mode, if Image 1 is 16:9 and Image 2 is 4:3, the latent sampler will crash. Ensure both images are resized to identical dimensions prior to node input.
⚙️ Oversaturated / Artifacted Video
When using the distilled transformer model, keep CFG set strictly to 1.0. Increasing CFG above 1.0 on distilled checkpoints causes severe color distortion and video corruption.
8. Conclusion & Next Steps
LTX-2.5 provides local video creators with a versatile open-weights foundation model. By understanding how to authenticate Hugging Face gated access, utilize distilled INT8 models, and structure multi-shot prompts, you can generate high-fidelity videos with synchronized audio right inside ComfyUI.
Next Steps to Explore
- Experiment with multi-cut narrative prompting (
SHOT 1+CUT TO+SHOT 2). - Try enabling the 2x Spatial Upscaler for two-stage 1440p renders.
- Explore related guides on our ComfyHub Tutorials Directory.