Licon MSR for LTX-2.5

Licon MSR for LTX-2.5

给模型最多五张参考图，让生成视频中的人物、服装、物体和背景保持一致。这是用于 ComfyUI 中 LTX-2.5 的 LoRA，还可以为两位说话者添加音频参考。

由 LiconStudio 在 Hugging Face 上制作。这些说明是 Mindket 根据它的模型页面和模型卡写的，模型自己的文件和许可证在 Hugging Face 上。

简介

它是什么：Licon MSR 是为 LTX-2.5 视频模型训练的 LoRA。你可以给模型几张参考图，让生成的片段保持相同的人物、服装、物体和场景。较新的 V2 版本还支持最多两位说话者的音频参考。

适合谁：想让同样的主体出现在多个生成镜头里的视频创作者和 ComfyUI 用户。已经在运行 LTX-2.5、想更好控制谁和什么出现在画面里的人都适合。

Industry | Who uses it | How they use it | Example
视频制作 | 短片和片段的制作者 | 提供人物和场景参考，让演员阵容保持一致 | 一个有两个角色、用三张图搭起场景的片段
营销 | 内容创作者 | 把产品和人物放进同一个生成镜头 | 带有主持人参考的产品展示
游戏和动画 | 概念美术师 | 测试人物和道具在场景中的运动 | 预览一个角色在多个镜头角度下的样子
研究 | 视频生成研究人员 | 研究视频模型中的多参考条件控制 | 比较不同参考标签下的结果

如果你不使用 LTX-2.5 或 ComfyUI，可以跳过它，因为它就是为那个模型做的。请只使用你有权使用的人脸和声音。

用在哪里：

• ComfyUI，并安装 ComfyUI-LTX2.5-MSR 插件
• 装有 Python 的 Windows、macOS 或 Linux，用来获取文件
• 已经在运行 LTX-2.5 基础模型的工作流

Use case | Who | What they get back
多角色视频 | 视频创作者 | 保留每个被参考角色的片段
主体与物体合成 | 设计师 | 把人物、物体和背景合在一起的场景
会说话的主体 | 创作者 | 与对应主体图片配对的语音

如何设置：

• Python，用来安装 Hugging Face 客户端
• ComfyUI 和 LTX-2.5 基础模型
• ComfyUI-LTX2.5-MSR 插件，模型卡说 ComfyUI 需要它

1. 安装 Hugging Face 客户端。
2. 把模型文件下载到你的电脑。
3. 在 ComfyUI 中安装 ComfyUI-LTX2.5-MSR 插件。
4. 打开插件附带的示例工作流。

pip install -U huggingface_hub
hf download LiconStudio/LTX-2.5-Multiple-Subject-Reference

如何使用：在示例工作流里加载最多五张参考图，并在提示词里描述每一张。添加语音时，让每段音频先经过 LTXV Audio VAE Encode 节点。再把它得到的 LATENT 接到 Multi-Reference Guide 的 audio_ref1 槽位或 audio_ref2 槽位。这两个槽位对应 pic1 和 pic2。如果某个主体没有音频，就让该音频输入空着。

Tool | What it does
Multi-Reference Guide | 接收你的参考图片和音频的主节点
LTXV Audio VAE Encode | 为引导节点编码每段音频
audio_ref1 and audio_ref2 | 把说话者音频与 pic1 和 pic2 配对的输入

示例：你加载三张参考图，在提示词里把它们标为 Image 1、Image 2 和 Image 3，并说明每一张是什么，比如角色、物体和背景。你还描述动作和各个对象所在的位置。模型会返回一段保留这三者的视频。

新手与专家：如果你是新手，先打开示例工作流，从两张参考图和一个简短清晰的提示词开始。在提示词里给每张图命名，并把音频匹配到正确的主体。

如果你熟悉这个领域：参考图会被转成视觉词元，与目标视频共享同一个潜在空间。每张图有一个学到的槽位嵌入和自己的负时间位置，所以视频词元通过原生的自注意力层获取细节。

参考图
带槽位嵌入的视觉词元
自注意力检索
生成的视频

注意事项：V2 减少了穿模，增加了更多样的镜头运动，动作更自然，突兀的剪切更少。一个已知问题是，环境声音需要语音参考里带有背景音乐。

• Limits: 最多五张参考图，最多两位说话者的音频
• Known issue: 如果语音参考里没有背景音乐，环境声音可能无法正确生成
• License: Apache 2.0
• Cost to run: 未提及
• Data it reaches: 下载到你电脑上的模型文件，以及你提供的参考图片和音频
• Not for: 模型卡没有列出，所以请只使用你有权使用的人脸和声音

Hugging Face 上的数据（2026年11月14日）

• 框架：diffusers
• 最近 30 天下载：14,885
• 点赞：110
• 许可证：apache-2.0
• 基于：Lightricks/LTX-2.5
• 标签：diffusers, video-generation, multi-reference, ltx-2.5

链接

• 模型：https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference
• 文件：https://huggingface.co/LiconStudio/LTX-2.5-Multiple-Subject-Reference/tree/main

获取模型

用 Hugging Face 的命令行下载它的文件：

pip install -U huggingface_hub
hf download LiconStudio/LTX-2.5-Multiple-Subject-Reference

然后按它的模型卡使用它。这个工具包里没有会自己运行的东西。