JZL - 🤖 MiniMax-H3短剧导演台Pro
The all-in-one that turns a script, some assets, and H3 into finished clips
- model
- clip
- vae
- audio_vae
- 图像
- 音频
- 已处理剧本
"MiniMax-H3生成管理器" (Generation Manager) is the pack's everything-node: it fuses what would otherwise be a fifteen-node subgraph - the per-shot prompt handling, the scene/video/audio reference routing, the official H3 ImageToVideo / ReferenceToVideo encoding, the sampler, and the VAE decode of video plus audio - into a single node that chews through a whole script and produces per-segment clips. It's the node you reach for when the "short drama" workflow is the whole point, not a rabbit hole you want to assemble by hand.
How it works
Under the hood it runs the same encoding pipeline as the pack's individual nodes: it reads the manager's configuration (assets, model choices, generation params, sampling/decode settings) from a modal dialog, clears and repopulates a global asset pool, splits your prompt_input on [SHOT_START]…[SHOT_END] blocks, and for each segment picks an encoding path from mode:
纯文本生成音视频-T2VA- text only.首帧图生成音视频-I2VA/尾帧图生成音视频-L2VA- first/last frame image.首尾帧生成音视频-FL2VA- first and last frame (default).音视频生成音视频-VA2VA- video-to-video with paired audio.多参考生成音视频-REF2VA- the multi-reference ref2va path.
Each segment's scene/video/audio instructions are resolved against the asset pool by name (it also honors @assetname mentions in the prompt), then encoded, sampled, and decoded to image frames plus audio. Results land in an internal bus pool keyed by segment index.
The inputs that matter
mode- the six-way generation-mode switch above. This decides which official H3 encoder path runs.video_count- number of segments, 1–12.prompt_input- the script/story, with[SHOT_START]blocks and optional@asset references.
Optionally it accepts clip, vae, audio_vae, and model directly. If those aren't connected, it can't generate - it'll still do the segmentation and report errors per segment, which is a handy dry-run behavior. Outputs are 生成总线 (a JSON bus describing each segment: mode, prompt, has_image, has_audio, frames, errors) and 资产清单 (the asset manifest). The bus feeds the pack's "视频保存分配" (Video Save Distributor).
How to install it
Part of the whole pack - ComfyUI Manager, search "ComfyUI-JZL-MiniMax-H3", or:
cd ComfyUI/custom_nodes
git clone https://github.com/wjluoxiao/ComfyUI-JZL-MiniMax-H3
Restart. Heavy dependencies here: torch, torchaudio (audio VAE encode), and imageio-ffmpeg as a fallback for pulling frames out of reference videos when your system lacks ffmpeg. It expects a recent ComfyUI with the official H3 nodes available (comfy_api.latest), and the audio_vae is required for the VA2VA/REF2VA modes.
Common issues
Two things bite people. First, the modes have prerequisites: REF2VA/VA2VA refuse to generate without audio_vae, and if clip/vae/model aren't wired the node silently degrades to "segmentation only" - check the bus JSON for error entries when nothing comes out. Second, asset names in the pool must match the scheduling instructions exactly (the pack uses names like 图片1角色孙悟空); a typo means an empty slot and a clip that ignores its reference. And the usual H3 caveat stands: the ~42.5GB weights come from ComfyUI's official H3 loaders and the MiniMax H3 Community License excludes the US, EU, UK, and South Korea from local runs.
Inputs (17)
| Name | Type | Default | Description |
|---|---|---|---|
| run_mode | COMBO | 🛠️ 故事拆解模式 | 故事拆解模式=按情节把故事拆解为N段(不创意扩展);故事扩写模式=只按风格+字数把故事扩写为丰满正文(不拆解,纯文本经「已处理剧本」输出);穿透生成模式=跳过LLM拆解与增强,直接用提示词生成(含[SHOT_START]块则逐段,否则单段);仅提示词输出=拆解+增强的完整分段剧本文本经「已处理剧本」输出,不生成视频 |
| display_info | STRING | 分辨率:832x480丨每段帧数:192丨共计段数:6丨总帧数:1152丨总时长:48秒 | 只读显示:当前画幅/MP/时长/段数计算出的分辨率、每段帧数、段数、总帧数、总时长(对齐倍数固定 32) |
| aspect_ratio | COMBO | 16:9 (Widescreen) | 画幅比例(分辨率按 MP×1024² 公式自动计算,对齐倍数固定 32) |
| megapixels | FLOAT | 0.40.1–16 | 总像素数(MP),画幅×MP 决定分辨率 |
| duration | STRING | 5-5 | 每段视频时长(秒),等同「剧本与镜头处理器」的每段视频时长(秒) |
| scale_factor | FLOAT | 1.01–5 | 参考图放大系数 |
| upscale_scale | FLOAT | 1.001–4 | 二采(Ref2va)放大倍数 |
| video_count | INT | 11–48 | 生成视频数量(分段数,支持 1~48 任意值;统一控制:提示词拆解段数 / 分发列表数 / 采样数 / 分段保存数) |
| story_style | COMBO | 热血战斗 | 故事风格(剧本处理器按此风格拆解与润色) |
| story_name | STRING | 机智罗 | 故事名称(用于保存命名 / 日志) |
| external_prompt | STRING | 提示词接线输入(与 CLIP Text Encode 同类):此输入框左上角圆点可拖线连接上游 STRING 文本节点;连线后以上游文本为提示词(优先于「节点内提示词」大框;未接且留空则用大框内容) | |
| internal_prompt | STRING | 节点内编辑的提示词(提示词来源,随工作流保存) | |
| manager_settings | STRING | 本节点独立保存的完整配置 JSON(资产/增强/采样解码),随工作流保存,节点间互不影响 | |
| modelopt | MODEL | — | |
| clipopt | CLIP | — | |
| vaeopt | VAE | — | |
| audio_vaeopt | VAE | — |
Outputs (3)
| Name | Type | Description |
|---|---|---|
| 图像 | IMAGE | — |
| 音频 | AUDIO | — |
| 已处理剧本 | STRING | 全部LLM处理后的剧本/提示词文本:纯提示词生成模式=LLM处理结果;其余模式=拆解+增强后的分段文本 |