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

Advanced MiniMax H3 Image to Video (Combined)

MiniMax H3 image-to-video when you want the model patched too

By silveroxides·Created 2 months ago·Updated about 7 hours ago· 24
Advanced MiniMax H3 Image to Video (Combined)
  • 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

The plain UC_AdvancedMiniMaxH3ImageToVideo builds your H3 conditioning and latent. This is the "Combined" sibling that goes one step further: it also takes the diffusion model and returns it back, patched when needed - so a single node can hand you model, positive, and LATENT, all three wires for the sampling branch, from one place. It's the node to reach for when your H3 workflow wants reference-derived first/last keyframes and you'd rather not assemble the patching yourself.

What "Combined" adds

The core schema matches the Advanced node - clip (H3's Qwen3-VL 32B encoder, post UC_MiniMaxH3ClipProjectionPatcher), vae, prompt, width/height (1344×768 defaults), length (frame count snapped upward to H3's 17k+5 grid), multiplier, ref_image_size, vlm_resolution - plus the same optional first_frame, last_frame, visual_fusion_config, reference_images, fusion_images, and media_config.

The difference is in the ref_image_size combo and the new model input/output. The Advanced node's match/max/none behavior is retained, and "first" modes are added: first routes the first ordered reference to frame zero, first + last also routes the final reference to the final frame when more than one exists, and match/max sizing then applies to the remaining native references. Each endpoint gets VAE-encoded once.

The model input is where the magic (and the one real gotcha) lives. In mixed keyframe/reference modes, the node returns a patched clone of the model - the tooltip says it plainly: "Mixed keyframe/reference modes return a patched clone; single conditioning modes return this model unchanged." So when you wire the model output into your sampler, you must use the output, not the original model you fed in. The description hammers this home: "Connect the returned model to the same sampling branch as the positive conditioning and latent." People who wire the original model back and wonder why their keyframes got ignored have found the node's one trap.

The setup you can't skip

Same as the sibling: load the encoder via Core's Load CLIP with type minimax, patch it with UC_MiniMaxH3ClipProjectionPatcher, and drop a matching Qwen3-VL→H3 projection (4B or 8B, plain or residual-MLP) into ComfyUI/models/clip_projections/. The H3 video VAE is required, and the generic ref_latent_mode must stay off - H3 uses Core's dedicated reference conditioning.

Outputs

Three sockets: model, positive (CONDITIONING), and LATENT. All three go to the sampler. If you don't need keyframe derivation or model patching, the plain Advanced node is simpler and does the same conditioning job; this node exists for the workflow that wants first/last-frame anchors derived automatically from its reference list.

Install

ComfyUI Manager → search ComfyUI-UtilsCollection → install, or:

cd ComfyUI/custom_nodes
git clone https://github.com/silveroxides/ComfyUI-UtilsCollection

Restart. Deps are opencv-python and typing-extensions; the real cost is H3's weights (~42.5GB) and remembering the H3 Community License geofences out the US, EU, UK and South Korea for local-weight use.

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