ComfyUI_MiniMaxH3_Director r2v参考主体指南：用素材组与公共参数锁定角色一致性

ComfyUI_MiniMaxH3_Director r2v参考主体指南：用素材组与公共参数锁定角色一致性

【免费下载链接】ComfyUI_MiniMaxH3_DirectorMulti-segment MiniMax H3 Director for official ComfyUI MiniMax-H3项目地址: https://gitcode.com/gh_mirrors/com/ComfyUI_MiniMaxH3_Director

ComfyUI_MiniMaxH3_Director是 ComfyUI 官方 MiniMax-H3 的多段音视频导演台插件。本指南聚焦它的r2v（参考主体生视频）模式，讲清如何用「公共参数」+「素材组」两层结构，在多镜头生成中锁定角色一致性——让同一个角色、服装、音色跨镜头不漂移，新手也能快速上手。

一、r2v 参考主体生成是什么？

r2v（Reference to Video）的核心思路是：用参考图 / 参考音频 / 参考视频作为条件，约束模型按"指定主体"生成视频。

槽位编号规则可在 lib/ref_images.py 中查看——MAX_REFERENCE_IMAGES = 9即官方MiniMaxH3ReferenceToVideo节点的上限。

⚠️ 注意：r2v需要ref2vaUNET（minimax_h3_ref2va_pruned_int8_convrot.safetensors），与 t2v/i2v 用的 fl2va 不同，别装错模型。

二、快速开始：加载 r2v 示例工作流

1. 确认 ComfyUI 已升级到v0.30.0+（含官方 MiniMax H3 节点），插件手动安装方式为：

cd ComfyUI/custom_nodes git clone https://gitcode.com/gh_mirrors/com/ComfyUI_MiniMaxH3_Director.git pip install -r ComfyUI_MiniMaxH3_Director/requirements.txt

2. 重启 ComfyUI，把 example_workflows/minimax_h3_director_r2v.json 拖入画布；
3. 连接model→video_vae→audio_vae→clip（CLIP 的 type 选minimax），导演台内编辑时间轴后即可 Queue。

各模型文件放置路径详见 example_workflows/README.md。

三、公共参数：锁定角色一致性的关键面板

「公共参数」是 r2v 保持跨镜头一致性的核心机制（默认折叠，点击「启用公共参数」展开）：

• 共享参考图 / 参考音频：放在这里，等于告诉模型"所有镜头都是这个主角"；
• 公共提示词：写角色锁定描述（如subject_definitions、服装、五官特征），启用后会自动与每一组提示词拼接，无需每段重复。

拼接逻辑在 director/gen_timeline.py 中：开启公共参数后，公共提示词经concat_common_segment_prompt拼到每组提示词前；同槽位参考素材则"组内优先覆盖公共"（merge_indexed_refs）。

📌 槽位编号小贴士：公共参数占用Picture 1–3时，组内图片从Picture4续编。组里不要把第一张改叫Picture1，否则提示词引用会错位。

四、素材组：每个镜头一张卡片

公共参数管"全局一致"，素材组管"单镜头内容"：

1. 点击「添加素材组」，每组独立写分镜提示词（镜头运动、场景、动作）；
2. 每组可再挂本组独有的图片 1–9 / 音频 1–3 / 视频 1–3，同槽位会覆盖公共素材——比如第 3 组换了一套服装，就给该组挂新的Picture1；
3. 提示词里用<Picture N>/<Video K>/<Audio J>指代素材，或输入@唤起引用菜单（前端实现见 web/js/minimax_prompt_mentions.js），启用公共参数时可选择公共或本组素材；
4. 时间轴实时预览各组时长与缩略图，「选择运行」可勾选只跑部分组，未勾选组用缓存/源画面填充，方便反复调试单个镜头。

五、进阶玩法

导演包：一键备份整套剧本 + 素材

工具栏「导入 / 导出导演包」生成*.mmxpack.zip，目录结构与界面槽位一一对应：

pack.json shared_params/shared_params.json # 公共参数 shared_params/Picture1.png # 公共参考图 asset_groups/01/group.json # 第 1 个素材组 asset_groups/01/Picture4.png timeline.json

把整集剧情的参考图、音频、分镜提示词打包带走，换机器直接导入，角色设定零丢失。

外部多组接线：批量跑角色

用MiniMax H3 Director Group (Reference to Video)节点把外部扩写、抠图结果按组打包，再经Director Groups Combine汇入导演台r2v_groups口（示例见 example_workflows/minimax_h3_director_external_groups_r2v.json）。外部接线优先覆盖 UI 素材，适合批量生成同一角色的多套镜头。

参考音频原声输出

给素材组挂上角色配音，声音模式可选「生成 / 原声」：选"用原声"时输出直接 mux 该段参考音频，画面口型贴原声，细节见 docs/r2v-source-audio.md。

六、常见问题速答

• Q：第二组开始角色就漂移？把角色参考图从"组内"移到「公共参数」，公共提示词里写足特征；并检查各组素材是否意外覆盖了公共槽位。
• Q：生成失败 / 节点报错？确认 UNET 是ref2va、CLIP type 是minimax，且 ComfyUI 版本 ≥ 0.30.0。
• Q：想只重跑第 2 组怎么办？开启「选择运行」，只勾选第 2 组；其余组命中缓存，省时省显存。

掌握「公共参数定人设、素材组写分镜」这一套组合拳，r2v 的多镜头角色一致性就不再是玄学，而是可复用的工程化流程 🎬。

【免费下载链接】ComfyUI_MiniMaxH3_DirectorMulti-segment MiniMax H3 Director for official ComfyUI MiniMax-H3项目地址: https://gitcode.com/gh_mirrors/com/ComfyUI_MiniMaxH3_Director