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 # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("LiconStudio/LTX-2.5-Multiple-Subject-Reference", dtype=torch.bfloat16, device_map="cuda") prompt = "Astronaut in a jungle, cold color palette, muted colors, detailed, 8k" image = pipe(prompt).images[0] - Notebooks
- Google Colab
- Kaggle
File size: 4,199 Bytes
2d32f4b 5384c50 9b9c228 5384c50 32aeb2c 5384c50 32aeb2c 5384c50 32aeb2c 5384c50 32aeb2c 5384c50 32aeb2c 5384c50 32aeb2c 5384c50 32aeb2c 5384c50 32aeb2c 5384c50 32aeb2c 5384c50 205a5a4 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 | ---
license: apache-2.0
library_name: diffusers
tags:
- video-generation
- multi-reference
- LTX-2.5
base_model:
- Lightricks/LTX-2.5
github: https://github.com/liconstudio/ComfyUI-LTX2.5-MSR
---
# 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](https://github.com/liconstudio/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`, and `Image 3`.
- Clearly specify subject actions and spatial relationships.
- Specify which reference provides the character, object, clothing, or background.
## Examples
<table>
<tr>
<th align="center">Example 03</th>
<th align="center">Example 06</th>
<th align="center">Example 07</th>
</tr>
<tr>
<td align="center">
<b>Reference Images</b><br><br>
<img src="https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/resolve/main/validition_V1/03/01.png" width="100%"><br>
<img src="https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/resolve/main/validition_V1/03/02.png" width="100%"><br>
<img src="https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/resolve/main/validition_V1/03/03.png" width="100%"><br><br>
<video src="https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/resolve/main/validition_V1/03/MiniMax_H3.mp4" controls width="100%"></video>
<br><b>MiniMax H3</b><br><br>
<video src="https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/resolve/main/validition_V1/03/MSR.mp4" controls width="100%"></video>
<br><b>Licon MSR V1</b>
</td>
<td align="center">
<b>Reference Images</b><br><br>
<img src="https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/resolve/main/validition_V1/06/01.png" width="100%"><br>
<img src="https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/resolve/main/validition_V1/06/02.png" width="100%"><br>
<img src="https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/resolve/main/validition_V1/06/03.png" width="100%"><br><br>
<video src="https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/resolve/main/validition_V1/06/MiniMax_H3_no-cut.mp4" controls width="100%"></video>
<br><b>MiniMax H3</b><br><br>
<video src="https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/resolve/main/validition_V1/06/MSR-no-cut.mp4" controls width="100%"></video>
<br><b>Licon MSR V1</b>
</td>
<td align="center">
<b>Reference Images</b><br><br>
<img src="https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/resolve/main/validition_V1/07/01.png" width="100%"><br>
<img src="https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/resolve/main/validition_V1/07/02.png" width="100%"><br>
<img src="https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/resolve/main/validition_V1/07/03.png" width="100%"><br><br>
<video src="https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/resolve/main/validition_V1/07/MiniMax_H3.mp4" controls width="100%"></video>
<br><b>MiniMax H3</b><br><br>
<video src="https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/resolve/main/validition_V1/07/MSR.mp4" controls width="100%"></video>
<br><b>Licon MSR V1</b>
</td>
</tr>
</table> |