Instructions to use LiconStudio/LTX-2.5-Multiple-Subject-Reference with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use LiconStudio/LTX-2.5-Multiple-Subject-Reference with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline from diffusers.utils import load_image, export_to_video # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("LiconStudio/LTX-2.5-Multiple-Subject-Reference", dtype=torch.bfloat16, device_map="cuda") pipe.to("cuda") prompt = "A man with short gray hair plays a red electric guitar." image = load_image( "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/diffusers/guitar-man.png" ) output = pipe(image=image, prompt=prompt).frames[0] export_to_video(output, "output.mp4") - Notebooks
- Google Colab
- Kaggle
Licon MSR V1 for LTX-2.5
Overview
Licon MSR V1 is a multi-reference LoRA trained for LTX-2.5.
It uses the Multiple Subject Reference (MSR) approach to encode multiple reference images as visual tokens in the same latent space as the target video. Each reference is assigned a learned slot embedding and a distinct negative temporal position, allowing target video tokens to retrieve character, clothing, object, and scene information through the model's native self-attention layers.
Key Features
- Supports up to five reference images
- Preserves multiple characters, clothing, objects, and backgrounds
- Learned slot embeddings distinguish different references
- Native self-attention retrieval of reference details
- Supports multi-subject and subject-object composition
- Designed specifically for the LTX-2.5 architecture
Usage
ComfyUI inference requires ComfyUI-LTX2.5-MSR. A sample workflow is included in the plugin repository.
Usage Tips
- Describe each reference image clearly in the prompt.
- Use consistent labels such as
Image 1,Image 2, andImage 3. - Clearly specify subject actions and spatial relationships.
- Specify which reference provides the character, object, clothing, or background.
Examples
| Example 03 | Example 06 | Example 07 |
|---|---|---|
|
Reference Images
|
Reference Images
|
Reference Images
|
- Downloads last month
- -
Model tree for LiconStudio/LTX-2.5-Multiple-Subject-Reference
Base model
Lightricks/LTX-2.5