Nodes/Deno Custom Nodes/(Deno) MiniMax H3 Reference to Video
ComfyUI Node

(Deno) MiniMax H3 Reference to Video

MiniMax H3 reference-to-video, with the messy image slots replaced by one ordered cable

By Deno2026·Created 5 months ago·Updated 2 days ago· 166
(Deno) MiniMax H3 Reference to Video
  • clip
  • vae
  • audio_vae
  • ref_images
  • ref_videos
  • ref_video_audios
  • ref_audios
  • positive
  • LATENT
prompt
width1344
height768
length124
ref_image_sizematch

If you've ever stared at the stock MiniMax H3 "Reference to Video" node and wondered which of the half-dozen image slots to wire into where - this is the version that answers that. (Deno) MiniMax H3 Reference to Video is a thin wrapper around ComfyUI's native H3 node that swaps the Autogrow image-input mess for a single ordered reference bundle. Everything else stays stock, including the prompt tags.

Context first, because it's why this node exists. MiniMax H3 (the open-weight model MiniMax/Hailuo announced in July 2026) is multimodal: it takes text, reference images, reference videos, and reference audio, and generates video with native sound - up to 15 seconds at 2K in the hosted tier, with reference inputs "baked in from the start," as the community put it. ComfyUI shipped native H3 nodes in 0.30.0, and the stock reference-image handling is a set of Autogrow slots that break on mixed-size references. Deno's loader + this node replace that with one cable.

How it works

The node subclasses ComfyUI's own MiniMaxH3ReferenceToVideo, so the mechanism is stock H3 - it's not a reimplementation. It re-exposes the ref_images input as the custom DENO_MINIMAX_H3_REFERENCE_IMAGES type from (Deno) MiniMax H3 Multi Reference Image Loader, and at execution it unpacks that ordered bundle back into the per-slot images H3 actually wants. The ref_videos, ref_video_audios, and ref_audios inputs stay as stock Autogrow sockets, in prompt-tag order. Because the image bundle is order-preserving, <Picture 1>, <Picture 2>, and so on in your prompt map straight to your loader's card order - same for <Video k> and <Audio j>.

Inputs that matter

  • clip, vae, audio_vae - H3's text/image encoder and its video and audio VAEs, straight from the stock MiniMax H3 loaders.
  • prompt - your generation prompt; reference images are <Picture 1>, <Picture 2>..., videos <Video 1>..., audio <Audio 1>...
  • width / height - 1344×768 by default.
  • length - frame count at 24 fps; default 124 (about 5 seconds), steps of 17.
  • ref_image_size - match (default) sizes references to the generation area; the other option runs the larger max-reference pipeline.
  • Optional: ref_images (the DENO bundle), plus stock ref_videos, ref_video_audios, ref_audios.

Outputs are the standard H3 pair: positive CONDITIONING with all the image/video/audio references baked in, and an empty LATENT for the sampler. Wire those into a MiniMax H3 sampler and decode.

Install

Part of the Deno Custom Nodes pack - ComfyUI Manager, search "deno custom nodes", or:

cd ComfyUI/custom_nodes
git clone https://github.com/Deno2026/comfyui-deno-custom-nodes.git
cd comfyui-deno-custom-nodes
python -m pip install -r requirements.txt

Restart, then make sure you're on ComfyUI 0.30.0 or newer - the node literally cannot exist without the native H3 node underneath. The H3 model files (checkpoint, CLIP, video VAE, audio VAE) load through the stock MiniMax H3 loaders in the same workflow; the Deno pack doesn't bundle or download them.

Where people get burned

The bundle is enforced, not optional: connect anything other than the DENO loader's ref_images and you'll get a clear "ref_images must come from the DENO MiniMax H3 Reference Image Loader" error. Empty bundle, same story. If the node itself is missing from the menu, your ComfyUI predates 0.30.0. And a reality check on expectations: H3 is a heavy multimodal model - images, video, and audio references plus generation on one card adds up, and reference images can be downscaled internally by ref_image_size regardless of what you feed in. Test one reference first, then scale up. The loader keeps your source pristine; the model's own reference-sizing pipeline is the part you tune.

Categorymodel/conditioning/minimax

Inputs (12)

NameTypeDefaultDescription
clipCLIPMiniMax H3 text/image encoder used to tokenize the prompt and references.
vaeVAEMiniMax H3 video VAE used to encode reference images and videos.
audio_vaeVAEMiniMax H3 audio VAE used to encode reference audio.
promptSTRINGPrompt for the generated video. Refer to loaded images as <Picture 1>, <Picture 2>, and so on.
widthINT134432–16384Generated video width in pixels.
heightINT76832–16384Generated video height in pixels.
lengthINT1245–3600Generated frame count at 24 fps.
ref_image_sizeCOMBOmatchKeep stock H3 reference sizing: match the generation area or use the larger max reference pipeline.
ref_imagesoptDENO_MINIMAX_H3_REFERENCE_IMAGESOrdered image bundle from the DENO MiniMax H3 Reference Image Loader.
ref_videosoptCOMFY_AUTOGROW_V3Stock MiniMax H3 reference-video slots, in prompt tag order.
ref_video_audiosoptCOMFY_AUTOGROW_V3Stock MiniMax H3 soundtrack slots paired by number with reference videos.
ref_audiosoptCOMFY_AUTOGROW_V3Stock MiniMax H3 standalone reference-audio slots, in prompt tag order.

Outputs (2)

NameTypeDescription
positiveCONDITIONINGPositive MiniMax H3 conditioning containing the ordered image, video, and audio references.
LATENTLATENTEmpty MiniMax H3 audio/video latent for sampling.