Nodes/ComfyUI-JZL-MiniMax-H3/JZL - 🤖 MiniMax-H3短剧导演台Pro
ComfyUI Node

JZL - 🤖 MiniMax-H3短剧导演台Pro

The all-in-one that turns a script, some assets, and H3 into finished clips

By wjluoxiao·Created about a month ago·Updated 3 days ago· 93
JZL - 🤖 MiniMax-H3短剧导演台Pro
  • model
  • clip
  • vae
  • audio_vae
  • 图像
  • 音频
  • 已处理剧本
run_mode🛠️ 故事拆解模式
display_info分辨率:832x480丨每段帧数:192丨共计段数:6丨总帧数:1152丨总时长:48秒
aspect_ratio16:9 (Widescreen)
megapixels0.4
duration5-5
scale_factor1.0
upscale_scale1.00
video_count1
story_style热血战斗
story_name机智罗
external_prompt
internal_prompt
manager_settings

"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.

CategoryJZL/MiniMax

Inputs (17)

NameTypeDefaultDescription
run_modeCOMBO🛠️ 故事拆解模式故事拆解模式=按情节把故事拆解为N段(不创意扩展);故事扩写模式=只按风格+字数把故事扩写为丰满正文(不拆解,纯文本经「已处理剧本」输出);穿透生成模式=跳过LLM拆解与增强,直接用提示词生成(含[SHOT_START]块则逐段,否则单段);仅提示词输出=拆解+增强的完整分段剧本文本经「已处理剧本」输出,不生成视频
display_infoSTRING分辨率:832x480丨每段帧数:192丨共计段数:6丨总帧数:1152丨总时长:48秒只读显示:当前画幅/MP/时长/段数计算出的分辨率、每段帧数、段数、总帧数、总时长(对齐倍数固定 32)
aspect_ratioCOMBO16:9 (Widescreen)画幅比例(分辨率按 MP×1024² 公式自动计算,对齐倍数固定 32)
megapixelsFLOAT0.40.1–16总像素数(MP),画幅×MP 决定分辨率
durationSTRING5-5每段视频时长(秒),等同「剧本与镜头处理器」的每段视频时长(秒)
scale_factorFLOAT1.01–5参考图放大系数
upscale_scaleFLOAT1.001–4二采(Ref2va)放大倍数
video_countINT11–48生成视频数量(分段数,支持 1~48 任意值;统一控制:提示词拆解段数 / 分发列表数 / 采样数 / 分段保存数)
story_styleCOMBO热血战斗故事风格(剧本处理器按此风格拆解与润色)
story_nameSTRING机智罗故事名称(用于保存命名 / 日志)
external_promptSTRING提示词接线输入(与 CLIP Text Encode 同类):此输入框左上角圆点可拖线连接上游 STRING 文本节点;连线后以上游文本为提示词(优先于「节点内提示词」大框;未接且留空则用大框内容)
internal_promptSTRING节点内编辑的提示词(提示词来源,随工作流保存)
manager_settingsSTRING本节点独立保存的完整配置 JSON(资产/增强/采样解码),随工作流保存,节点间互不影响
modeloptMODEL
clipoptCLIP
vaeoptVAE
audio_vaeoptVAE

Outputs (3)

NameTypeDescription
图像IMAGE
音频AUDIO
已处理剧本STRING全部LLM处理后的剧本/提示词文本:纯提示词生成模式=LLM处理结果;其余模式=拆解+增强后的分段文本