基于 ComfyUI 官方 MiniMax-H3 的多段音视频导演台插件。仓库地址：AIMixer/ComfyUI_MiniMaxH3_Director
English → README_EN.md
MiniMaxH3Director 是面向长视频、多段生成的 MiniMax H3 导演台节点，把分段计划、条件编码、采样解码和导出整合在一个节点里。底层走官方 MiniMaxH3ImageToVideo / MiniMaxH3ReferenceToVideo + MiniMaxH3SigmaShift + KSampler + AV 分离解码链路，原生输出立体声音频。
| 功能 | 说明 |
|---|---|
| 多段时间轴 | 节点内上传视频，支持切分、均分、智能分镜分割（PySceneDetect）、追加；分割点可选中删除；可视化时间轴预览每段范围与缩略图 |
| 多任务模式 | task_type：t2v（文生视频）、i2v（图生视频）、fl2v（首尾帧生视频）、r2v（参考主体生视频 / 素材组）、v2v（视频转视频）、rv2v（参考素材改视频） |
| 首尾帧 (fl2v) | 独立首尾帧时间轴：多组关键帧、「添加一组」上传首帧和/或尾帧（官方支持只传尾帧）；拖缘调时长；提示词写中间运动；支持「选择运行」只跑部分组 |
| 参考素材组 (r2v) | fl2v 式分组 UI：上方「公共参数」共享参考图/音频与公共提示词（与每组提示词拼接）；每组可再挂图片1–9 / 音频1–3 / 视频1–3；提示词用 <Picture N> / <Video K> / <Audio J>（或 @ 引用）；时间轴预览与选中状态同步 |
| 源视频编辑 (v2v / rv2v) | Bernini 风格源视频时间轴；每段源画面自动绑定 <Video 1>；rv2v 另可挂参考图（图片1–9）与参考音频（音频1–3） |
| 选择运行 | 开启后只采样勾选的片段/素材组；未勾选段可用缓存或源画面填充（全部导出时） |
| 外部多组接线 | Director Group (Image to Video) / (Reference to Video) + Groups Combine；连入导演台 i2v_groups / r2v_groups 后外部优先覆盖 UI 素材，仍支持跑批与选择运行 |
| 原生立体声音频 | 与画面同次采样生成；v2v/rv2v 可选生成声音 / 使用原声 / 静音 |
| 段间引导 | 默认关闭；多段 t2v / i2v / fl2v / r2v / v2v / rv2v 时可开启，将上一段生成结果的末尾运动（及生成音频）钉入下一段采样再裁掉前缀。上下文帧数：5 / 22 / 39 / 56，默认推荐为 22。感谢 ComfyUI-H3-Motion-Context 提供的实现思路 |
| 运行报告 | report 口输出分段计划、每段任务摘要 |
输入： model → video_vae → audio_vae → clip
可选： i2v_groups（Image to Video 多组）/ r2v_groups（Reference to Video 多组）
输出： images → audio → fps → frame_count → source_images → report
CLIP Loader 的 type 必须选
minimax（Qwen3-VL）。
t2v/i2v/fl2v用 fl2va UNET；r2v/v2v/rv2v用 ref2va UNET。
请将 ComfyUI 升级到 v0.30.0 及以上（含官方 MiniMax H3 节点：PR #15224、PR #15228）。
可选：scenedetect（智能分割）、opencv-python-headless（源视频解码）、imageio-ffmpeg（原声抽取）——见 requirements.txt。
cd ComfyUI/custom_nodes
git clone https://github.com/AIMixer/ComfyUI_MiniMaxH3_Director.git
pip install -r ComfyUI_MiniMaxH3_Director/requirements.txt重启 ComfyUI。
- 打开 ComfyUI Manager
- 选择 Install via Git URL
- 填入
https://github.com/AIMixer/ComfyUI_MiniMaxH3_Director.git并安装 - 重启 ComfyUI
完整资源包（MiniMax H3 模型权重 + 示例 JSON 工作流）见：
Comfyit 搅拌站 · 文章 506：MiniMax H3 模型和工作流
下载后将 models/ 合并到 ComfyUI/models/，JSON 工作流拖入 ComfyUI 即可。
也可参考：
- Hugging Face： Comfy-Org/MiniMax-H3
- ComfyUI 文档： MiniMax H3 工作流示例
本仓库自带示例：example_workflows/
| 工作流 | task_type | UNET | 说明 |
|---|---|---|---|
minimax_h3_director_t2v.json |
t2v | fl2va | 文生音视频 |
minimax_h3_director_fl2v.json |
fl2v | fl2va | 首尾帧（「添加一组」） |
minimax_h3_director_r2v.json |
r2v | ref2va | 参考改视频素材组 |
minimax_h3_director_v2v.json |
v2v | ref2va | 源视频时间轴编辑 |
minimax_h3_director_rv2v.json |
rv2v | ref2va | 源视频 + 参考图/音频 |
minimax_h3_director_external_groups_i2v.json |
fl2v | fl2va | 外部 Group×2 → Combine → i2v_groups |
minimax_h3_director_external_groups_r2v.json |
r2v | ref2va | 外部 Group×N → Combine → r2v_groups |
| 用途 | 文件名 | 目录 |
|---|---|---|
| UNET (t2v / i2v / fl2v) | minimax_h3_fl2va_pruned_int8_convrot.safetensors |
models/diffusion_models/ |
| UNET (r2v / v2v / rv2v) | minimax_h3_ref2va_pruned_int8_convrot.safetensors |
models/diffusion_models/ |
| CLIP | qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors |
models/text_encoders/ |
| Video VAE | minimax_h3_video_vae_fp16.safetensors |
models/vae/ |
| Audio VAE | minimax_h3_audio_vae_fp32.safetensors |
models/vae/ |
- 确认 ComfyUI ≥ 0.30.0，已能加载官方 MiniMax H3 节点
- 从 文章 506 或本仓库
example_workflows/加载示例 - 连接 UNET / CLIP / video_vae / audio_vae，在导演台 UI 内编辑时间轴与提示词后 Queue
视频教程： B 站合集 · 插件使用教程
- 画布默认 0.4MP 16:9（864×480），5 秒 / 124 帧 @ 24 fps（17k+5 网格）
- 25 steps，
res_multistep+simple，CFG 1.0 - Sigma shift：video 12 / audio 3
- 任务类型选 「首尾帧生视频 (fl2v)」
- 点击「添加一组」，上传首帧和/或尾帧（可只传尾帧）
- 在镜卡片或时间轴上调整时长；提示词写中间运动 / 镜头 / 过渡
- Queue 生成；多组可勾选「选择运行」只跑部分组
- 任务类型选 「参考主体生视频 (r2v)」（需 ref2va UNET + audio_vae）
- 点击 「启用公共参数」 展开面板（默认折叠/关闭）；上传共用参考图/音频并写公共提示词（如角色锁定 /
subject_definitions）；启用后会与每组提示词拼接 - 点击「添加素材组」；每组写分镜提示词，可按需再挂本组独有素材（同槽位覆盖公共素材）
- 提示词中用
<Picture N>/<Video K>/<Audio J>，或输入@（启用公共参数时可引用公共 + 本组素材） - 时间轴可预览各组时长与缩略图；「选择运行」与素材组勾选同步
- 选 v2v 或 rv2v，上传源视频并分段（切分 / 均分 / 智能分割）
- 每段写提示词；系统自动将源片段绑定为
<Video 1> rv2v可额外上传参考图 / 参考音频；声音模式可选生成 / 原声 / 静音
对齐官网两个 conditioning 节点，把扩写 / 抠图 / Load Video 等处理结果以多组形式送进导演台：
- 添加
MiniMax H3 Director Group (Image to Video)或(Reference to Video) - 按组接线：
prompt/duration_sec；I2V 系接first_frame/last_frame（无帧=t2v，仅首=i2v，仅尾或首+尾=fl2v）；R2V 为 Autogrow（同官方 Reference to Video）：接图/视频/音频会自动多出空口（图≤9、视频≤3、音频≤3）。输出宽高在导演台统一设置 - 多组：用
Director Groups Combine（Autogrow：接满最后一个口会自动多出新口，同官方 Reference to Video）→ 导演台i2v_groups/r2v_groups；单组可直接把group连到导演台 - 导演台
task_type与口一致（t2v/i2v/fl2v ↔i2v_groups；r2v ↔r2v_groups）；不要两口同时连接 - 连接后执行以图中接线为准（外部优先）；UI 卡片变淡，仍可用「选择运行」按组序勾选
配套生态 · Comfyit 搅拌站
Comfyit 提供环境、模型、工作流与教程配套：
| 栏目 | 链接 |
|---|---|
| 模型 / 工作流包 | comfyit.cn/article/506 |
| 官方 MiniMax H3 文档 | docs.comfy.org · MiniMax H3 |
| 插件视频教程 | B 站合集 |
| 产品中心 | comfyit.cn/products |
| 插件广场 | comfyit.cn/plugins |
| 模型广场 | comfyit.cn/resources/models |
| 工作流广场 | comfyit.cn/workflows |
| 维护者 | AI搅拌手 / AIMixer |
| 本仓库 | github.com/AIMixer/ComfyUI_MiniMaxH3_Director |
| 姊妹插件 | ComfyUI_Bernini_Director |
| 作者 QQ | 3697688140 |
| B 站 | space.bilibili.com/1997403556 |
| 插件教程 | B 站合集 · 使用教程 |
| QQ 交流群 | 551482703 · 425064221 · 559826331 |
| Comfyit 搅拌站 | comfyit.cn |
- Comfy-Org / ComfyUI — 官方 MiniMax H3 支持
- MiniMax-AI — MiniMax H3 模型
- Comfy-Org/MiniMax-H3 — 权重与文档
- NikoDemon80/ComfyUI-H3-Motion-Context — 段间运动/音频续拍思路参考
Apache-2.0