LTX-Video README

The project's README from github.com/Lightricks/LTX-Video. As one markdown file: README.md.

LTX-Video

Website Model Demo Paper Trainer Discord

This is the official repository for LTX-Video.


🚀 New: LTX-2 is Now Available!

We're excited to announce LTX-2 - the next generation of LTX with synchronized audio+video generation!

LTX-2 is the first DiT-based audio-video foundation model that contains all core capabilities of modern video generation in one model. LTX-2 is now the primary home for LTX development and includes significant improvements:

👉 Check out LTX-2 here

📖 View Documentation


Table of Contents

Introduction

LTX-Video is the first DiT-based video generation model that contains all core capabilities of modern video generation in one model: synchronized audio and video, high fidelity, multiple performance modes, production-ready outputs, API access, and open access. It can generate up to 50 FPS videos at native 4K resolution with synchronized audio in one pass. The model is trained on a large-scale dataset of diverse videos and can generate high-resolution videos with realistic and diverse content.

The model supports image-to-video, multi-keyframe conditioning, keyframe-based animation, video extension (both forward and backward), video-to-video transformations, and any combination of these features.

Image-to-video examples

example1 example2 example3
example4 example5 example6
example7 example8 example9

Controlled video examples

control0 control1 control2
control3 control4

News

October 23, 2025: LTX-2 Announced

Today we announced our newest foundation model, LTX-2. LTX-2 represents a major leap forward from our previous model, LTXV 0.9.8. Here’s what’s new:

For more details, please see our blog post. LTX-2 model weights, code, and benchmarks will be released to the community later in 2025.

July, 16th, 2025: New Distilled models v0.9.8 with up to 60 seconds of video:

July, 8th, 2025: New Control Models Released!

May, 14th, 2025: New distilled model 13B v0.9.7:

May, 5th, 2025: New model 13B v0.9.7:

April, 15th, 2025: New checkpoints v0.9.6:

March, 5th, 2025: New checkpoint v0.9.5

February, 20th, 2025: More inference options

December 31st, 2024: Research paper

December 20th, 2024: New checkpoint v0.9.1

November 21th, 2024: Initial release v0.9.0

Models

Name Notes inference.py config ComfyUI workflow (Recommended)
ltxv-13b-0.9.8-dev Highest quality, requires more VRAM ltxv-13b-0.9.8-dev.yaml ltxv-13b-i2v-base.json
ltxv-13b-0.9.8-mix Mix ltxv-13b-dev and ltxv-13b-distilled in the same multi-scale rendering workflow for balanced speed-quality N/A ltxv-13b-i2v-mixed-multiscale.json
ltxv-13b-0.9.8-distilled Faster, less VRAM usage, slight quality reduction compared to 13b. Ideal for rapid iterations ltxv-13b-0.9.8-distilled.yaml ltxv-13b-dist-i2v-base.json
ltxv-2b-0.9.8-distilled Smaller model, slight quality reduction compared to 13b distilled. Ideal for fast generation with light VRAM usage ltxv-2b-0.9.8-distilled.yaml N/A
ltxv-13b-0.9.8-dev-fp8 Quantized version of ltxv-13b ltxv-13b-0.9.8-dev-fp8.yaml ltxv-13b-i2v-base-fp8.json
ltxv-13b-0.9.8-distilled-fp8 Quantized version of ltxv-13b-distilled ltxv-13b-0.9.8-distilled-fp8.yaml ltxv-13b-dist-i2v-base-fp8.json
ltxv-2b-0.9.8-distilled-fp8 Quantized version of ltxv-2b-distilled ltxv-2b-0.9.8-distilled-fp8.yaml N/A
ltxv-2b-0.9.6 Good quality, lower VRAM requirement than ltxv-13b ltxv-2b-0.9.6-dev.yaml ltxvideo-i2v.json
ltxv-2b-0.9.6-distilled 15× faster, real-time capable, fewer steps needed, no STG/CFG required ltxv-2b-0.9.6-distilled.yaml ltxvideo-i2v-distilled.json

Quick Start Guide

Online inference

The model is accessible right away via the following links:

Run locally

Installation

The codebase was tested with Python 3.10.5, CUDA version 12.2, and supports PyTorch >= 2.1.2. On macOS, MPS was tested with PyTorch 2.3.0, and should support PyTorch == 2.3 or >= 2.6.

git clone https://github.com/Lightricks/LTX-Video.git
cd LTX-Video

# create env
python -m venv env
source env/bin/activate
python -m pip install -e .\[inference\]

FP8 Kernels (optional)

FP8 kernels developed for LTX-Video provide performance boost on supported graphics cards (Ada architecture and later). To install FP8 kernels, follow the instructions in that repository.

Inference

📝 Note: For best results, we recommend using our ComfyUI workflow. We're working on updating the inference.py script to match the high quality and output fidelity of ComfyUI.

To use our model, please follow the inference code in inference.py:

For image-to-video generation:

python inference.py --prompt "PROMPT" --conditioning_media_paths IMAGE_PATH --conditioning_start_frames 0 --height HEIGHT --width WIDTH --num_frames NUM_FRAMES --seed SEED --pipeline_config configs/ltxv-13b-0.9.8-distilled.yaml

Extending a video:

📝 Note: Input video segments must contain a multiple of 8 frames plus 1 (e.g., 9, 17, 25, etc.), and the target frame number should be a multiple of 8.

python inference.py --prompt "PROMPT" --conditioning_media_paths VIDEO_PATH --conditioning_start_frames START_FRAME --height HEIGHT --width WIDTH --num_frames NUM_FRAMES --seed SEED --pipeline_config configs/ltxv-13b-0.9.8-distilled.yaml

For video generation with multiple conditions:

You can now generate a video conditioned on a set of images and/or short video segments. Simply provide a list of paths to the images or video segments you want to condition on, along with their target frame numbers in the generated video. You can also specify the conditioning strength for each item (default: 1.0).

python inference.py --prompt "PROMPT" --conditioning_media_paths IMAGE_OR_VIDEO_PATH_1 IMAGE_OR_VIDEO_PATH_2 --conditioning_start_frames TARGET_FRAME_1 TARGET_FRAME_2 --height HEIGHT --width WIDTH --num_frames NUM_FRAMES --seed SEED --pipeline_config configs/ltxv-13b-0.9.8-distilled.yaml

Using as a library

from ltx_video.inference import infer, InferenceConfig

infer(
    InferenceConfig(
        pipeline_config="configs/ltxv-13b-0.9.8-distilled.yaml",
        prompt=PROMPT,
        height=HEIGHT,
        width=WIDTH,
        num_frames=NUM_FRAMES,
        output_path="output.mp4",
    )
)

ComfyUI Integration

To use our model with ComfyUI, please follow the instructions at https://github.com/Lightricks/ComfyUI-LTXVideo/.

Diffusers Integration

To use our model with the Diffusers Python library, check out the official documentation.

Diffusers also support an 8-bit version of LTX-Video, see details below

Model User Guide

📝 Prompt Engineering

When writing prompts, focus on detailed, chronological descriptions of actions and scenes. Include specific movements, appearances, camera angles, and environmental details - all in a single flowing paragraph. Start directly with the action, and keep descriptions literal and precise. Think like a cinematographer describing a shot list. Keep within 200 words. For best results, build your prompts using this structure:

Automatic Prompt Enhancement

When using LTXVideoPipeline directly, you can enable prompt enhancement by setting

LTX-Video (Lightricks/LTX-Video)

Searching Database…

11.1K ·GitHub
这是什么?LTX-Video 是 Lightricks 公司基于 DiT 的视频生成模型的官方代码仓库。该模型可以生成同步的音频和视频,支持文生视频、图生视频、关键帧条件控制、视频延长以及视频到视频的转换。
这是一个独立应用,还是需要我集成到自己的流程里?它是一个模型加 Python 代码库:你可以通过 inference.py 脚本运行它,在自己的代码里把它当作 Python 库使用,或者把模型权重接入 ComfyUI 或 Diffusers。
我到底要怎么用它生成视频?安装依赖后,运行 inference.py,并指定一个模型配置 yaml 文件(例如 ltxv-13b-0.9.8-dev.yaml),即可用于图生视频、文生视频、视频延长或多条件生成。
要在本地运行,需要什么软件和硬件?需要 Python 3.10.5、CUDA 12.2 和 PyTorch >= 2.1.2;在 macOS 上,搭配 PyTorch 2.3.0+ 可以使用 MPS。可选的 FP8 内核在 Ada 架构或更新的 GPU 上能带来速度提升。
自带的 inference.py 效果能比得上我在演示中看到的吗?目前还不能。README 中提到,inference.py 仍在更新中,以达到你在 ComfyUI 工作流中得到的质量和保真度,而官方推荐使用 ComfyUI 工作流以获得最佳效果。
我能在 Mac 上运行吗,还是必须要 Nvidia GPU?主要支持的是带 CUDA 的 Nvidia GPU,但 Apple Silicon Mac 也可以通过 PyTorch 的 MPS 后端运行。
LTX-2 是什么?它和这个仓库有什么关系?LTX-2 是 Lightricks 的下一代模型,是首个基于 DiT 同时生成音频和视频的模型,支持原生 4K、最高 50 fps,片段长度可达 10 秒。其权重和代码计划稍后发布,并将成为 LTX 后续开发的主要阵地。
我应该先用哪个模型权重?如果显存充足,想要最高质量,就用 ltxv-13b-0.9.8-dev;如果想要更快的生成速度和更低的显存占用,可以选择 13B 或 2B 的蒸馏版/fp8 变体,质量会略有损失。
不安装任何东西,能先试试 LTX-Video 吗?可以,它可以通过 LTX-Studio、Fal.ai 和 Replicate 在线使用,无需本地配置。
我能自定义风格,或者添加深度、姿态之类的控制信号吗?可以。LTX-Video 支持用 LoRA 微调来定制风格,并且有专门的 IC-LoRA 控制模型,用于深度、姿态和 Canny 边缘条件控制。
Creator
Lightricks
Size
0.1 MB
Stars
11.1K
Updated
CommitJan 05
Age
1y
Commits · 90 Days