Nodes/CRT-Nodes/MiniMax H3 US Config (CRT)
ComfyUI Node

MiniMax H3 US Config (CRT)

MiniMax H3 US Config — one prompt box to drive the whole generation

By PGCRT·Created 2 years ago·Updated 2 days ago· 132
MiniMax H3 US Config (CRT)
  • First Frame (I2V)
  • Last Frame (I2V)
  • Ref Image 1 (REF2VA)
  • Ref Image 2 (REF2VA)
  • Ref Image 3 (REF2VA)
  • Ref Image 4 (REF2VA)
  • Ref Image 5 (REF2VA)
  • Ref Image 6 (REF2VA)
  • Ref Image 7 (REF2VA)
  • Ref Image 8 (REF2VA)
  • Ref Image 9 (REF2VA)
  • Ref Video 1 (REF2VA)
  • Ref Video 2 (REF2VA)
  • Ref Video 3 (REF2VA)
  • Ref Video Audio 1 (REF2VA)
  • Ref Video Audio 2 (REF2VA)
  • Ref Video Audio 3 (REF2VA)
  • Ref Audio 1 (REF2VA)
  • Ref Audio 2 (REF2VA)
  • Ref Audio 3 (REF2VA)
  • config_pipe
prompt
seed0
Frames (override)0
MegaPixels (override)0.00

MiniMax H3 doesn't take a prompt like a normal image model. It takes a structured brief - the visual description, the soundscape, the music - and the MiniMax H3 US Config (CRT) node is where all of that lives, along with your seed, your keyframes and every reference you want REF2VA to look at. It bundles the whole per-run setup into one config_pipe and hands it to the Unified Sampler. Think of it as the "what do you want" half of the pipeline; the sampler is the "go do it" half.

This is the pattern CRT uses across its video packs (the LTX2.5 Unified Sampler set works the same way), and once you've used it, the payoff is clear: you iterate on a prompt or swap a reference frame without touching a dozen sampler widgets.

The prompt structure

This is the part people get wrong first. H3's official prompt format uses labeled sections, and the node's prompt box follows it exactly:

  • integrated_multimodal_description: - shots, motion, camera, what's on screen.
  • overall_soundscape: - ambient sound, dialogue, SFX.
  • non_diegetic_music: - optional, the score.

In REF2VA mode you address your media inline with tags: <Picture 1>, <Video 2>, <Audio 3>. If a reference isn't tagged in the prompt, the model has no instruction to use it - the tags are the hook.

Inputs that matter

The required pair is prompt (multiline, and it supports dynamic prompts) and seed (with the usual randomize-on-generate control). Then the optional inputs split by mode:

  • I2V: First Frame (I2V) and Last Frame (I2V) - your two keyframes.
  • REF2VA: up to nine Ref Image sockets, three Ref Video sockets (an IMAGE batch at 24 fps - the author recommends 48+ frames), three Ref Video Audio sockets paired with those videos, and three standalone Ref Audio sockets.

There are also two overrides, both defaulting to 0 (meaning "keep the sampler's setting"): Frames (override) - snap a specific frame count, ceil-snapped to H3's 17n+5 grid - and MegaPixels (override) - force a resolution instead of the sampler's megapixels_target. Handy when one workflow needs to be shorter or higher-res than the default.

Output: a single config_pipe that goes straight into the Unified Sampler's config_pipe socket.

Install

Part of CRT-Nodes by PGCRT. ComfyUI Manager → search CRT-Nodes → install → restart, or:

cd ComfyUI/custom_nodes
git clone https://github.com/PGCRT/CRT-Nodes.git
pip install -r requirements.txt

Restart ComfyUI. On pack updates, a node showing red or NaN gets fixed by right-click → Fix node (recreate).

Gotchas

Keep REF2VA inputs inside the official limits - nine images, three videos, three standalone audios, twelve files max mixed - because that's the cap the model was trained with, and stuffing more in just gets ignored. Ref videos should be 24 fps with decent length. And the standing H3 caveat: the weights are licensed for local use only outside the US, EU, UK and South Korea, so check the territory before you lean on this workflow.

CategoryCRT/MiniMaxH3

Inputs (24)

NameTypeDefaultDescription
promptSTRINGOfficial prompt structure: 'integrated_multimodal_description:' (shots/motion), 'overall_soundscape:' (ambient/dialogue/SFX) and, optionally, 'non_diegetic_music:'. In R2V address references as <Picture i> / <Video k> / <Audio j>.
seedINT00–18446744073709550000
First Frame (I2V)optIMAGEFL2VA starting keyframe. The first frame is a geometry anchor stretched to the canvas.
Last Frame (I2V)optIMAGEFL2VA ending keyframe. Aspect-preserving cover-crop; motion is generated between both frames.
Ref Image 1 (REF2VA)optIMAGEREF2VA reference image 1, addressed as <Picture 1> in the prompt.
Ref Image 2 (REF2VA)optIMAGEREF2VA reference image 2, addressed as <Picture 2> in the prompt.
Ref Image 3 (REF2VA)optIMAGEREF2VA reference image 3, addressed as <Picture 3> in the prompt.
Ref Image 4 (REF2VA)optIMAGEREF2VA reference image 4, addressed as <Picture 4> in the prompt.
Ref Image 5 (REF2VA)optIMAGEREF2VA reference image 5, addressed as <Picture 5> in the prompt.
Ref Image 6 (REF2VA)optIMAGEREF2VA reference image 6, addressed as <Picture 6> in the prompt.
Ref Image 7 (REF2VA)optIMAGEREF2VA reference image 7, addressed as <Picture 7> in the prompt.
Ref Image 8 (REF2VA)optIMAGEREF2VA reference image 8, addressed as <Picture 8> in the prompt.
Ref Image 9 (REF2VA)optIMAGEREF2VA reference image 9, addressed as <Picture 9> in the prompt.
Ref Video 1 (REF2VA)optIMAGEREF2VA reference video 1 as an IMAGE batch at 24 fps (2-15s at 24 fps, 48+ frames recommended), addressed as <Video 1> in the prompt.
Ref Video 2 (REF2VA)optIMAGEREF2VA reference video 2 as an IMAGE batch at 24 fps (2-15s at 24 fps, 48+ frames recommended), addressed as <Video 2> in the prompt.
Ref Video 3 (REF2VA)optIMAGEREF2VA reference video 3 as an IMAGE batch at 24 fps (2-15s at 24 fps, 48+ frames recommended), addressed as <Video 3> in the prompt.
Ref Video Audio 1 (REF2VA)optAUDIOSoundtrack paired with Ref Video 1; addressed as its own <Audio> tag before <Video 1>.
Ref Video Audio 2 (REF2VA)optAUDIOSoundtrack paired with Ref Video 2; addressed as its own <Audio> tag before <Video 2>.
Ref Video Audio 3 (REF2VA)optAUDIOSoundtrack paired with Ref Video 3; addressed as its own <Audio> tag before <Video 3>.
Ref Audio 1 (REF2VA)optAUDIOStandalone REF2VA reference audio 1, addressed as <Audio j> in the prompt.
Ref Audio 2 (REF2VA)optAUDIOStandalone REF2VA reference audio 2, addressed as <Audio j> in the prompt.
Ref Audio 3 (REF2VA)optAUDIOStandalone REF2VA reference audio 3, addressed as <Audio j> in the prompt.
Frames (override)optINT00–4096Values above 0 override the sampler frame count; snapped up to the 17n+5 grid. 0 keeps the sampler setting.
MegaPixels (override)optFLOAT0.000–16Values above 0 override the sampler megapixels_target; 0 keeps the sampler setting.

Outputs (1)

NameTypeDescription
config_pipeMINIMAXH3_US_CONFIG_PIPE