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>