Reference

Workflow & Asset Compatibility

Use this page before assembling or modifying a workflow. Choose the row that matches your input and goal, then follow its linked workflow or template.

This is a reference guide, not an exhaustive listing of every workflow JSON in the repository.

These rows are all ComfyUI workflows. For the native Python runtime, see the PyTorch API; for the hosted API, see the API documentation.

Compatibility rules

  • Keep LTX-2.5 and LTX-2.3 workflows and assets separate unless a workflow or model card explicitly establishes compatibility.
  • Start from an official template or workflow, run it unchanged once, then add adapters or custom nodes one at a time.
  • An adapter’s model card is the source of truth for its compatible base model, loader, prompt wording, and strength.
  • Standard LoRAs and IC-LoRAs are different paths. The official LTX-2.5 workflow directory has task-specific IC-LoRA workflows. A standard LoRA requires manually adding ComfyUI’s core LoraLoaderModelOnly node to the selected baseline template.
  • Do not infer native ltx-pipelines file paths or supported features from a ComfyUI workflow (or the reverse).

Standard ComfyUI model files (BF16)

Use this higher-quality BF16 configuration as the reference stack for a standard LTX-2.5 ComfyUI workflow. A workflow can omit parts of it: for example, Text-to-Audio has no video branch and a single-stage workflow does not use the spatial upscaler.

FileRoleComfyUI folderUsed by
ltx-2.5-22b-distilled-transformer-bf16.safetensorsDistilled LTX-2.5 transformerComfyUI/models/diffusion_models/Standard LTX-2.5 workflows in this reference
gemma4-12b-with-proj-ltx-2.5-bf16.safetensorsLTX text encoderComfyUI/models/text_encoders/Prompt-conditioned LTX-2.5 workflows
gemma4_e2b_it_bf16.safetensorsOptional local prompt enhancerComfyUI/models/text_encoders/Official local templates that enable Prompt Enhance
ltx-2.5-video-vae-bf16.safetensorsVideo VAEComfyUI/models/vae/Video workflows; not Text-to-Audio
ltx-2.5-audio-vae-bf16.safetensorsAudio VAEComfyUI/models/vae/Workflows that generate or condition on audio
ltx-2.5-latent-spatial-upscaler-x2-bf16-1.0.safetensors2× spatial upscalerComfyUI/models/latent_upscale_models/Two-stage workflows only

Lower-VRAM ComfyUI configuration

For a lower-VRAM local setup with the distilled LTX-2.5 video workflows, use these three files together instead of their BF16 counterparts in the reference stack.

FileRoleComfyUI folder
ltx-2.5-22b-distilled-transformer-comfy-int8-convrot.safetensorsINT8 ConvRot distilled transformerComfyUI/models/diffusion_models/
gemma4-12b-with-proj-ltx-2.5-comfy-int8-convrot.safetensorsINT8 ConvRot Gemma text encoderComfyUI/models/text_encoders/
ltx-2.5-video-vae-conv-bf16.safetensorsConv video VAE; faster and lighter than the DiffVAEComfyUI/models/vae/

Text-to-Audio has no video branch, so it uses only the INT8 ConvRot transformer and text encoder together with the BF16 audio VAE.

The *-comfy-int8-convrot files are ComfyUI-only. Do not use them with native ltx-pipelines or the PyTorch API; use the BF16 files for those paths instead.

LTX-2.5 core workflows

GoalTemplateRequired inputKey compatibility notes
Text-to-VideoComfyUI template video_ltx2_5_t2vText promptTwo-stage template; generates synchronized video and audio. Start with the reference BF16 stack, or use the lower-VRAM configuration above.
Image-to-VideoComfyUI template video_ltx2_5_i2vSource image and supporting promptTwo-stage template. Use First-Frame / Last-Frame instead when both endpoints are supplied.
First-Frame / Last-FrameComfyUI template video_ltx2_5_flf2vStart image and end imageSingle-stage template for motion between two frames; do not assume the two-stage upscaler is used.
Audio-to-VideoLTX-2.5_A2V_Two_Stage_Distilled.jsonInput audio and a visual prompt; first image is optionalTwo-stage. The audio is the primary conditioning signal and is held fixed while video is generated.
Text-to-AudioLTX-2.5_T2A_Single_Stage_Distilled.jsonText promptAudio-only: use the audio VAE, not the video VAE or spatial upscaler.
Advanced two-stage T2V/I2VLTX-2.5_T2V_I2V_Two_Stage_Distilled.jsonText prompt; source image when using I2VBase generation followed by 2× spatial upscaling and refinement. Use the LTX-2.5 spatial upscaler.

LTX-2.5 IC-LoRA workflows

IC-LoRAs condition a generation on a reference input or control signal. Choose the task-specific workflow below, then follow its adapter card for the required assets, prompt wording, loader, and strength.

WorkflowWhat you need to know
Generic video-to-video IC-LoRA workflowInput: Reference video and a compatible adapter. Notes: Single-stage; follow the adapter card for its checkpoint, loader, prompt, and strength.
Union Control workflowInput: Reference video plus depth, canny, or pose control. Notes: ComfyUI-VideoDepthAnything and comfyui_controlnet_aux for the documented preprocessors.
Motion Control workflowInput: Prompt, opening image, and drawn sparse motion tracks. Notes: The opening image conditions the first frame and is the canvas for the tracks.
Inpainting workflowInput: Source video and mask. Notes: Two-stage; white mask regions are generated and black regions are preserved.
Outpainting workflowInput: Source video and target canvas. Notes: Two-stage; the padded region becomes the generated area.

LTX-2.3 specialized workflows

These workflows use LTX-2.3 assets and are not currently validated on LTX-2.5.

GoalOfficial starting pointRequired inputStatus
Video-to-Audio FoleyFoley V2A workflowMuted source video and a foley promptThe input video is preserved while the Foley track is generated.
Text-to-Audio FoleyLTX-2.3_T2A_Single_Stage_Distilled.json plus the Foley LoRAText promptDo not use the LTX-2.5 Text-to-Audio workflow as a substitute.
Dub-ItLTX-2.3_ICLoRA_DubIt_Two_Stage_Distilled.jsonSource video and replacement dialogueGenerates lip-synced replacement speech; it does not translate dialogue automatically.
RelightRelight guideExterior reference video, light-direction ball, and directional promptThe light-direction ball is part of the conditioning, not a decorative overlay.

Before you change a workflow

  1. Confirm the LTX version in the workflow, checkpoint, adapter card, and model files all match.
  2. Load the official workflow and run it without edits.
  3. Make one change at a time and test.
  4. Record the exact workflow source revision and the model-file identifiers used for a reproducible result.