Nodes/ComfyUI-UtilsCollection/Adv MiniMax H3 Image to Video Combined (TokenFusion)
ComfyUI Node

Adv MiniMax H3 Image to Video Combined (TokenFusion)

Reference images that become real VAE keyframes

By silveroxides·Created 2 months ago·Updated about 7 hours ago· 24
Adv MiniMax H3 Image to Video Combined (TokenFusion)
  • model
  • clip
  • vae
  • first_frame
  • last_frame
  • visual_fusion_config
  • reference_images
  • fusion_images
  • media_config
  • model
  • positive
  • LATENT
prompt
width1344
height768
length124
multiplier1.0
ref_image_sizematch
vlm_resolution384

If you read the TokenFusion article first, this is the sibling that changes one thing that matters: it takes the model as input and gives it back to you patched. UC_AdvMiniMaxH3ImageToVideoTokenFusion returns conditioning and a latent and expects your model to be wired in separately. This "Combined" variant returns model (a patched clone when it needs one), positive, and LATENT - and all three are meant to feed the exact same sampling branch. That's the "combined" contract: model, conditioning, and latent travel together, which is how the pack's MiniMax H3 nodes work best.

The other thing "Combined" adds is the keyframe trick. The plain node treats your images as Qwen pictures - tokens the VLM reasons about. This one can go further via ref_image_size: set it to one of the "First" modes and the first ordered reference gets routed to frame zero as a real VAE-encoded keyframe; use "first + last" and the final reference anchors the final frame too. That's meaningful for video because a true keyframe at the endpoint constrains the start and end frames at the latent level, not just as a prompt hint. Non-endpoint references still get treated as native H3 references and numbered Qwen pictures, and each endpoint gets VAE-encoded exactly once. Frames and references still can't be mixed with explicit frame inputs in reference mode, and a mixed keyframe/reference setup returns the patched model clone while single-conditioning modes pass the model through unchanged.

Inputs otherwise mirror the TokenFusion node: clip is MiniMax H3's Qwen3-VL 32B encoder (qwen3vl_32b), vae is the H3 video VAE, prompt is the raw prompt with Picture labels supplied by Core from connected image roles. width/height default to 1344x768, length defaults to 124 frames (snapped upward to H3's 17k+5 temporal grid - don't be surprised when 124 becomes a nearby number), multiplier scales the Qwen conditioning and pooled output without touching VAE keyframes or the latent, and vlm_resolution (default 384) sets the equivalent-square resolution the encoder sees.

The optional autogrow sockets - first_frame, last_frame, reference_images, fusion_images - plus visual_fusion_config and media_config form the full routing contract, and there are two subtleties worth flagging. In reference mode, fusion_images pairs with reference pictures by index (one image on fusion_image_1 broadcasts to all of them), and the media_config can add Qwen-only Video blocks and optional native audio conditioning - but video blocks are never fusion targets. If a socket doesn't match the expected layout, you get an error rather than silent weirdness, which is honestly the friendlier failure mode.

Install and model requirements are identical to the rest of the pack and covered in the TokenFusion article: Manager or git clone, light Python deps, then the real work of grabbing MiniMax H3, the Qwen3-VL 32B encoder (or a 4B/8B plus a clip projection into ComfyUI/models/clip_projections/), and the H3 VAE. Same license caveat applies - H3's community license excludes the US, EU, UK, and Korea, so check your territory before downloading anything.

Where people get burned with this node is almost never the node itself - it's wiring the three outputs into different samplers or forgetting that keyframe mode and explicit frame inputs are mutually exclusive. Keep model, positive, and LATENT on one branch and you're most of the way there.

Categoryadvanced/conditioning

Inputs (16)

NameTypeDefaultDescription
modelMODELMiniMax H3 diffusion model. Mixed keyframe/reference modes return a patched clone; single conditioning modes return this model unchanged.
clipCLIPMiniMax H3 Qwen3-VL 32B text encoder (qwen3vl_32b).
vaeVAEMiniMax H3 video VAE used for connected frame anchors and native image references.
promptSTRINGRaw MiniMax H3 prompt. Picture labels are supplied by Core from the connected image roles.
widthINT134432–16384
heightINT76832–16384
lengthINT1245–3600Frame count at 24 fps, snapped upward to MiniMax H3's 17k+5 temporal grid.
multiplierFLOAT1.0-1000–1000Scales the final Qwen conditioning and pooled output; does not alter VAE keyframes or the H3 latent.
ref_image_sizeCOMBOmatchMatch, max, and none retain the Advanced node behavior. First modes route the first ordered reference to frame zero; first + last modes also route the final reference to the final frame when more than one exists. Match or max applies only to remaining native references. Each endpoint is VAE-encoded once.
vlm_resolutionINT3840–4096Equivalent-square Qwen3-VL target from 256 to 3584. Values outside that range preserve the original image resolution. This is independent of VAE frame and reference sizing.
first_frameoptIMAGEOptional frame-zero VAE anchor and the first numbered Qwen picture.
last_frameoptIMAGEOptional final-frame VAE anchor and the next numbered Qwen picture.
visual_fusion_configoptVISUAL_FUSION_CONFIGOptional spatial method. With frame inputs, fusion_image_1 targets Picture 1 and fusion_image_2 targets Picture 2; disconnected or off keeps fusion images as separate numbered Qwen pictures outside native-reference mode. See fusion_images for the complete routing contract.
reference_imagesoptCOMFY_AUTOGROW_V3Ordered native H3 references and numbered Qwen pictures. Hybrid ref_image_size modes derive endpoint keyframes after socket and batch flattening. Reference mode cannot be combined with explicit frame or fusion inputs.
fusion_imagesoptCOMFY_AUTOGROW_V3Qwen-only fusion contract. Active method: with frames, socket N targets Picture N and every batch item is another source; an unmatched socket errors. With native references, one image on fusion_image_1 broadcasts to every reference Picture; otherwise flattened fusion images pair by index and extras beyond the reference count are ignored. Without frames or references, all fusion images combine into Picture 1. Method off keeps them as separate Pictures, except native-reference mode ignores them. Video blocks are never fusion targets.
media_configoptMINIMAX_H3_MEDIA_CONFIGAdds a Qwen-only Video after existing Pictures and optional native audio. It creates no native video latent and excludes Video blocks from fusion; active mixed-media fusion requires grid-deepstack.

Outputs (3)

NameTypeDescription
modelMODEL
positiveCONDITIONING
LATENTLATENT