Back to All Tutorials
Intermediate24 min read

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.

By CGFlowStudio
2026-08-19

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.

🔑 IMPORTANT: Hugging Face Gated Repository Access Required

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:

  1. Log into your Hugging Face Account and accept the LTX-2.5 license terms.
  2. Generate a User Access Token (Read Permission) under Settings → Access Tokens.
  3. Add your token to ComfyUI via comfyui-manager or by setting the environment variable HF_TOKEN=your_token_here. Alternatively, download model files manually as shown in Section 3.

Loading Templates in ComfyUI

1 Update ComfyUI

Update ComfyUI to the latest version to ensure all core LTX-2.5 nodes (LTXVideoSampler, LTXVideoPipeline) are registered.

2 Open Template Library

Click the Templates tab in the ComfyUI menu bar and navigate to Video → LTX-2.5.

3 Select Your Template

Choose one of the three pre-built official workflows:

Template 1

Text-to-Video (T2V)

Generates video and synchronized audio from text prompts with optional 2x spatial upscaling.

Template 2

Image-to-Video (I2V)

Uses a reference image as the initial keyframe while driving motion and camera via prompt.

Template 3

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 Model Directory Hierarchy ComfyUI/models/
📂 ComfyUI/models/
📁 diffusion_models/
📄 ltx-2.5-transformer-distilled-int8-convrot.safetensors (Low-VRAM 8-Step Model)
📁 text_encoders/
📄 gemma-4-12b-ltx-projected.safetensors (Custom Gemma 4 12B Backbone)
📁 vae/
📄 ltx-2.5-diff-vae.safetensors (Diffusion Video Decoder - High Detail)
📄 ltx-2.5-audio-vae.safetensors (32 kHz Stereo Audio VAE)
📁 latent_upscale_models/
📄 ltx-2.5-spatial-upscaler-2x.safetensors (Used in T2V & I2V two-stage pipelines)

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.

T2V Pipeline Flow
Gemma 4 Text Encoder LTX-2.5 Distilled DiT (8 Steps) 2x Spatial Upscaler (Optional) Diffusion Video Decoder + Audio VAE
  1. Load T2V Template: Open Templates -> Video -> LTX-2.5 -> Text-to-Video.
  2. Set Prompt: Enter your prompt into the text box. Check Enable Prompt Enhancer to automatically expand camera instructions.
  3. Configure Sampler:
    • Steps: Set to 8.
    • CFG: Keep locked at 1.0 for the distilled model.
  4. 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).
  5. 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.

I2V Routing Flow
Load Image (First Frame)
LTXVideoSampler
[image_latent conditioning]
Diffusion Video Decoder → Video + Audio Output
  1. Load I2V Template: Open Templates -> Video -> LTX-2.5 -> Image-to-Video.
  2. Upload Reference Image: Load your image into the Load Image node.
  3. 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."
  4. 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.

FLF2V Dual Keyframe Flow
Load Image 1 (Start)
Load Image 2 (End)
LTXVideoSampler
[start_frame & end_frame]
Interpolated Video + Audio
  1. Load FLF2V Template: Open Templates -> Video -> LTX-2.5 -> First & Last Frame.
  2. Match Aspect Ratios: Ensure Image 1 and Image 2 share identical dimensions and aspect ratios (e.g. both 1280x720).
  3. 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."
  4. 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.

Recommended Prompt Blueprint
[Cinematic Style & Environment] + [SHOT 1: Camera & Action] + [CUT TO] + [SHOT 2: Expression] + [AUDIO: Foley & Dialogue]

Good vs. Weak Prompt Comparison

❌ Weak Prompt

"A man drinking coffee inside a café."

Lacks camera tracking details, lighting cues, temporal pacing, and audio instruction.

✅ Strong Multi-Shot Prompt

"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

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.safetensors model. 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.