Nodes/ComfyUI-Apt_Preset/AD_MiniMax_guide
ComfyUI Node

AD_MiniMax_guide

MiniMax H3 ref-to-video, but you name your references in the prompt

By cardenluo·Created 2 years ago·Updated 7 days ago· 331
AD_MiniMax_guide
  • clip
  • vae
  • audio_vae
  • media
  • media_1
  • media_2
  • media_3
  • media_4
  • media_5
  • media_6
  • media_7
  • media_8
  • media_9
  • media_10
  • media_11
  • media_12
  • media_13
  • media_14
  • media_15
  • media_16
  • media_17
  • media_18
  • media_19
  • media_20
  • media_21
  • media_22
  • media_23
  • media_24
  • media_25
  • media_26
  • media_27
  • media_28
  • media_29
  • media_30
  • media_31
  • media_32
  • media_33
  • media_34
  • media_35
  • media_36
  • media_37
  • media_38
  • media_39
  • media_40
  • media_41
  • media_42
  • media_43
  • media_44
  • media_45
  • media_46
  • media_47
  • media_48
  • media_49
  • media_50
  • media_51
  • media_52
  • media_53
  • media_54
  • media_55
  • media_56
  • media_57
  • media_58
  • media_59
  • media_60
  • media_61
  • media_62
  • media_63
  • media_64
  • positive
  • latent
  • trim_frames
  • text
prompt
width512
height768
length124
ref_image_sizematch
media_type_1
media_type_2
media_type_3
media_type_4
media_type_5
media_type_6
media_type_7
media_type_8
media_type_9
media_type_10
media_type_11
media_type_12
media_type_13
media_type_14
media_type_15
media_type_16
media_type_17
media_type_18
media_type_19
media_type_20
media_type_21
media_type_22
media_type_23
media_type_24
media_type_25
media_type_26
media_type_27
media_type_28
media_type_29
media_type_30
media_type_31
media_type_32
media_type_33
media_type_34
media_type_35
media_type_36
media_type_37
media_type_38
media_type_39
media_type_40
media_type_41
media_type_42
media_type_43
media_type_44
media_type_45
media_type_46
media_type_47
media_type_48
media_type_49
media_type_50
media_type_51
media_type_52
media_type_53
media_type_54
media_type_55
media_type_56
media_type_57
media_type_58
media_type_59
media_type_60
media_type_61
media_type_62
media_type_63
media_type_64

MiniMax H3 is the open-weight multimodal video model that took r/StableDiffusion by storm in mid-2026, and this is the pack's flagship way of driving it. AD_MiniMax_guide is a reference-to-video conditioning node: you give it a prompt plus up to fifteen media references - images, videos, even audio clips - and it bakes all of that into a single CONDITIONING plus a starting LATENT. It's the newest node in the pack (added 2026-08-08), and the author calls it "a simple and efficient way of working." That's not marketing; it genuinely is.

The neat part is how the references work. You don't have to remember which socket is which reference. You write tags in the prompt itself - <Picture 1>, <Video 2>, <Audio 1>, plus [Shot 1] for shots and <Subject 1> for character consistency - and the node swaps them for the actual media you plugged into the corresponding slots. Chinese aliases work too (图片, 视频, 音频), since the author's home turf is the Chinese ComfyUI scene.

How it works

It's a big wrapper around ComfyUI's native MiniMax H3 support. Each media slot is sniffed for its type (a tensor is an image, a waveform payload is audio, a video component is a video), then resized and encoded: images get VAE-encoded after scaling to the canvas (or aligned to the H3 2048 short edge in "max" mode), videos get resampled to 24 fps and VAE-encoded with their frame count snapped to the H3 17k + 5 grid, and audio gets encoded through the audio_vae at its native 32 kHz. The references are attached to the conditioning via minimax_refs, and the resolved prompt text comes back out as a third output so you can see exactly what was sent.

The length input is where the H3 quirk lives: it's in frames at 24 fps, and the tooltip tells you it auto-snaps to the 17k+5 grid - 124 ≈ 5s. That's why you'll see weird-but-correct values like 124, 141, 158.

Inputs and outputs

The required inputs mirror what an H3 encode needs: clip, vae, audio_vae, prompt (multiline, and the tags go here), width/height (multiples of 32), length (frames, 5 to 3600, snapped to the grid), and ref_image_size (match scales references to the canvas area, max aligns the 2048 short edge - better identity, slower).

Then the media zoo: media accepts IMAGE, VIDEO, AUDIO or even a STRING (if you feed it a string it becomes the prompt), and media_1 through media_15 each accept IMAGE, VIDEO, or AUDIO. There's a matching media_type_1..15 string input you can use to force a type when the sniffer is ambiguous, though usually you can leave it empty.

Outputs: positive (CONDITIONING), latent (LATENT), and text - the resolved prompt with tags expanded. The conditioning feeds your sampler; the latent is your starting point.

Installing it

It lives in ComfyUI-Apt_Preset, so install the pack (Manager → search "ComfyUI-Apt_Preset", or git clone https://github.com/cardenluo/ComfyUI-Apt_Preset into custom_nodes), then run install.bat or pip install -r requirements.txt and restart. Load the actual H3 model with the pack's sum_load_MiniMaxH3 loader, which hands you the clip, VAEs, and a context in one go.

Gotchas

  • It needs a recent ComfyUI with native H3 support. The code imports from comfy_extras.nodes_minimax_h3; on an older build it raises "This ComfyUI build does not provide MiniMax H3 support." Update ComfyUI before you debug anything else.
  • Slot limits are enforced: max 9 images, 3 videos, 3 audio clips across all fifteen slots. Exceed it and you get an explicit error.
  • Reference videos need at least 5 frames (~0.2s at 24 fps) and get their count snapped down to the grid.
  • H3 is a big multimodal model - this is not a 4 GB VRAM hobby. Bring a real GPU.
CategoryApt_Preset/AD/😺backup

Inputs (137)

NameTypeDefaultDescription
promptSTRING
widthINT51232–4096
heightINT76832–4096
lengthINT1245–3600帧数(24 fps),自动 snap 到 17k+5 网格(124 ≈ 5s)
ref_image_sizeCOMBOmatch'match' 缩放到画布面积;'max' 对齐 2048 短边(身份更好但更慢)
clipoptCLIP
vaeoptVAE
audio_vaeoptVAE
mediaoptIMAGE,VIDEO,AUDIO,LATENT,STRING
media_1optIMAGE,VIDEO,AUDIO,LATENT
media_type_1optSTRING
media_2optIMAGE,VIDEO,AUDIO,LATENT
media_type_2optSTRING
media_3optIMAGE,VIDEO,AUDIO,LATENT
media_type_3optSTRING
media_4optIMAGE,VIDEO,AUDIO,LATENT
media_type_4optSTRING
media_5optIMAGE,VIDEO,AUDIO,LATENT
media_type_5optSTRING
media_6optIMAGE,VIDEO,AUDIO,LATENT
media_type_6optSTRING
media_7optIMAGE,VIDEO,AUDIO,LATENT
media_type_7optSTRING
media_8optIMAGE,VIDEO,AUDIO,LATENT
media_type_8optSTRING
media_9optIMAGE,VIDEO,AUDIO,LATENT
media_type_9optSTRING
media_10optIMAGE,VIDEO,AUDIO,LATENT
media_type_10optSTRING
media_11optIMAGE,VIDEO,AUDIO,LATENT
media_type_11optSTRING
media_12optIMAGE,VIDEO,AUDIO,LATENT
media_type_12optSTRING
media_13optIMAGE,VIDEO,AUDIO,LATENT
media_type_13optSTRING
media_14optIMAGE,VIDEO,AUDIO,LATENT
media_type_14optSTRING
media_15optIMAGE,VIDEO,AUDIO,LATENT
media_type_15optSTRING
media_16optIMAGE,VIDEO,AUDIO,LATENT
media_type_16optSTRING
media_17optIMAGE,VIDEO,AUDIO,LATENT
media_type_17optSTRING
media_18optIMAGE,VIDEO,AUDIO,LATENT
media_type_18optSTRING
media_19optIMAGE,VIDEO,AUDIO,LATENT
media_type_19optSTRING
media_20optIMAGE,VIDEO,AUDIO,LATENT
media_type_20optSTRING
media_21optIMAGE,VIDEO,AUDIO,LATENT
media_type_21optSTRING
media_22optIMAGE,VIDEO,AUDIO,LATENT
media_type_22optSTRING
media_23optIMAGE,VIDEO,AUDIO,LATENT
media_type_23optSTRING
media_24optIMAGE,VIDEO,AUDIO,LATENT
media_type_24optSTRING
media_25optIMAGE,VIDEO,AUDIO,LATENT
media_type_25optSTRING
media_26optIMAGE,VIDEO,AUDIO,LATENT
media_type_26optSTRING
media_27optIMAGE,VIDEO,AUDIO,LATENT
media_type_27optSTRING
media_28optIMAGE,VIDEO,AUDIO,LATENT
media_type_28optSTRING
media_29optIMAGE,VIDEO,AUDIO,LATENT
media_type_29optSTRING
media_30optIMAGE,VIDEO,AUDIO,LATENT
media_type_30optSTRING
media_31optIMAGE,VIDEO,AUDIO,LATENT
media_type_31optSTRING
media_32optIMAGE,VIDEO,AUDIO,LATENT
media_type_32optSTRING
media_33optIMAGE,VIDEO,AUDIO,LATENT
media_type_33optSTRING
media_34optIMAGE,VIDEO,AUDIO,LATENT
media_type_34optSTRING
media_35optIMAGE,VIDEO,AUDIO,LATENT
media_type_35optSTRING
media_36optIMAGE,VIDEO,AUDIO,LATENT
media_type_36optSTRING
media_37optIMAGE,VIDEO,AUDIO,LATENT
media_type_37optSTRING
media_38optIMAGE,VIDEO,AUDIO,LATENT
media_type_38optSTRING
media_39optIMAGE,VIDEO,AUDIO,LATENT
media_type_39optSTRING
media_40optIMAGE,VIDEO,AUDIO,LATENT
media_type_40optSTRING
media_41optIMAGE,VIDEO,AUDIO,LATENT
media_type_41optSTRING
media_42optIMAGE,VIDEO,AUDIO,LATENT
media_type_42optSTRING
media_43optIMAGE,VIDEO,AUDIO,LATENT
media_type_43optSTRING
media_44optIMAGE,VIDEO,AUDIO,LATENT
media_type_44optSTRING
media_45optIMAGE,VIDEO,AUDIO,LATENT
media_type_45optSTRING
media_46optIMAGE,VIDEO,AUDIO,LATENT
media_type_46optSTRING
media_47optIMAGE,VIDEO,AUDIO,LATENT
media_type_47optSTRING
media_48optIMAGE,VIDEO,AUDIO,LATENT
media_type_48optSTRING
media_49optIMAGE,VIDEO,AUDIO,LATENT
media_type_49optSTRING
media_50optIMAGE,VIDEO,AUDIO,LATENT
media_type_50optSTRING
media_51optIMAGE,VIDEO,AUDIO,LATENT
media_type_51optSTRING
media_52optIMAGE,VIDEO,AUDIO,LATENT
media_type_52optSTRING
media_53optIMAGE,VIDEO,AUDIO,LATENT
media_type_53optSTRING
media_54optIMAGE,VIDEO,AUDIO,LATENT
media_type_54optSTRING
media_55optIMAGE,VIDEO,AUDIO,LATENT
media_type_55optSTRING
media_56optIMAGE,VIDEO,AUDIO,LATENT
media_type_56optSTRING
media_57optIMAGE,VIDEO,AUDIO,LATENT
media_type_57optSTRING
media_58optIMAGE,VIDEO,AUDIO,LATENT
media_type_58optSTRING
media_59optIMAGE,VIDEO,AUDIO,LATENT
media_type_59optSTRING
media_60optIMAGE,VIDEO,AUDIO,LATENT
media_type_60optSTRING
media_61optIMAGE,VIDEO,AUDIO,LATENT
media_type_61optSTRING
media_62optIMAGE,VIDEO,AUDIO,LATENT
media_type_62optSTRING
media_63optIMAGE,VIDEO,AUDIO,LATENT
media_type_63optSTRING
media_64optIMAGE,VIDEO,AUDIO,LATENT
media_type_64optSTRING

Outputs (4)

NameTypeDescription
positiveCONDITIONING
latentLATENT
trim_framesINT
textSTRING