ComfyUI MiniMax H3 导演包与外部多组接线:剧本+素材导入导出及跑批完整指南
【免费下载链接】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 多段音视频「导演台」插件:一个节点内完成分段计划、提示词管理、采样解码与导出。它的两大王牌是导演包(mmxpack)——把整份剧本(时间轴 JSON)和全部素材(参考图/视频/音频)打包成 zip 一键导入导出,以及外部多组接线——用第三方节点把扩写、抠图、Load Video 等结果按组送入导演台批量跑片。本指南带你从零用会这两个功能。
一、导演台长什么样
导演台把「分段计划 + 条件编码 + 采样解码 + 导出」整合在单个节点里,底层走官方MiniMaxH3ImageToVideo/MiniMaxH3ReferenceToVideo+KSampler链路,原生输出立体声音频。支持 6 种任务模式:t2v(文生)、i2v(图生)、fl2v(首尾帧)、r2v(参考素材组)、v2v(视频转视频)、rv2v(参考素材改视频),详见 README.md。
二、导演包:剧本 + 素材的一键导入导出
在导演台工具栏右侧点击「导入导演包 / 导出导演包」(minimax_timeline.js),导出得到*.mmxpack.zip。
1. 导演包里有什么
| 内容 | 包内路径 |
|---|---|
| 包元信息(格式、任务类型、采样参数) | pack.json |
| 公共参数(共享参考图/音频 + 公共提示词) | shared_params/ |
| 第 1 组素材与提示词 | asset_groups/01/ |
| 参考图 / 视频 / 音频 | Picture1.png、Video1.mp4、Audio1.wav |
| fl2v 首尾帧 | 组内start.jpg/end.jpg |
| v2v 源视频 | source_video/ |
| 完整时间轴(无损往返) | timeline.json |
典型结构如下(源码:director/pack.py):
pack.json shared_params/shared_params.json shared_params/Picture1.png asset_groups/01/group.json asset_groups/01/Picture4.png timeline.json2. 导出流程
- 在导演台 UI 里编辑好时间轴、提示词与素材;
- 点击「导出导演包」,前端把时间轴 POST 给后端(minimax_pack.js),后端打包成 zip 流式下载;
- 文件名形如
MiniMaxH3Director-r2v-20260101-120000.mmxpack.zip。
打包逻辑会自动把散落在input/各处的素材复制到包内的标准目录,槽位编号与界面一致(公共参数占用 Picture 1–3 时,组内从Picture4续编)。
3. 导入流程与注意点
- 点击「导入导演包」选择 zip,导入会覆盖当前节点时间轴(有确认提示);
- 媒体统一落到 ComfyUI 的
input/minimax_director_packs/下(pack.py),按随机 pack id 隔离,不会污染原有input/; - 包内路径全部为 ASCII,与英文界面用语对应,避免中文路径编码问题;
- 第三方工具也可以只写
pack.json+shared_params/+asset_groups/,不必手写timeline.json,插件会自动拼装时间轴(import_extracted_pack); - 包不含 UNET / CLIP / VAE 权重,只打包「剧本 + 素材」。
典型场景:同事 A 写好剧本导出.mmxpack.zip→ 同事 B 在自己机器上导入,直接开跑,素材无需手动搬运。
三、外部多组接线:把第三方节点结果送进导演台
除了 UI 内编辑,导演台还支持图内接线方式批量投喂分组任务——适合把「扩写提示词 / 抠图 / Load Video」等上游处理结果以多组形式送入。相关节点定义在 nodes/director_groups.py,示例工作流见 example_workflows/minimax_h3_director_external_groups_i2v.json。
1. 三个核心节点
| 节点 | 作用 |
|---|---|
MiniMax H3 Director Group (Image to Video) | 打包一组 I2V 任务:prompt+duration_sec+ 可选first_frame/last_frame |
MiniMax H3 Director Group (Reference to Video) | 打包一组 R2V 任务:参考图≤9 / 参考视频≤3 / 参考音频≤3(Autogrow 自动扩口) |
MiniMax H3 Director Groups Combine | 把多组合并成一个列表(Autogrow:接满最后一个口自动长出新口) |
2. 接线五步走
- 添加 Group 节点,按组接线:
prompt口可直接接扩写/改写节点的输出; - I2V 系按帧自动判定子类型:无帧 = t2v,仅首帧 = i2v,仅尾帧或首+尾 = fl2v(infer_i2v_kind);
- 多组时接入
Director Groups Combine→ 连到导演台i2v_groups或r2v_groups;单组可把group直连导演台; - 导演台
task_type必须与所连的口一致(t2v/i2v/fl2v ↔i2v_groups;r2v ↔r2v_groups),两口不要同时连接; - 连接后执行以图中接线为准(外部优先),UI 素材卡片变淡但仍可用「选择运行」按组序勾选。
3. 跑批与选择运行
- 画布分辨率由导演台统一控制,Group 节点不决定输出宽高;
- 每组的
duration_sec会自动吸附到 MiniMax 的 17k+5 帧网格; - 开启「选择运行」后只采样勾选的组,未勾选段可用缓存或源画面填充(全部导出时),非常适合「先粗跑几组挑风格、再补跑全量」的工作流;
- 接线变更会被缓存面板自动侦测(外部接线见证机制,web/js/minimax_external_witness.js),改线后旧缓存不会误用。
四、快速上手清单
- 确认 ComfyUI ≥0.30.0,已加载官方 MiniMax H3 节点;
- 拖入示例工作流:外部接线 I2V 版 minimax_h3_director_external_groups_i2v.json 或 R2V 版 minimax_h3_director_external_groups_r2v.json;
- 连接 UNET / CLIP(type 选
minimax)/ video_vae / audio_vae; - 需要复用剧本时:工具栏「导出导演包」→ 分享
.mmxpack.zip→ 对方「导入导演包」; - 需要批量投喂时:Group 节点 → Groups Combine → 导演台组口,勾「选择运行」开始跑批。
更多任务模式(fl2v 首尾帧、v2v 源视频编辑、Refine 二采)详见 README.md 与 example_workflows/README.md。
【免费下载链接】ComfyUI_MiniMaxH3_DirectorMulti-segment MiniMax H3 Director for official ComfyUI MiniMax-H3项目地址: https://gitcode.com/gh_mirrors/com/ComfyUI_MiniMaxH3_Director
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考