VRGDG MiniMax H3 Reference Media From Paths

MiniMax H3 is a reference-driven model: you can hand it up to nine reference images and three reference videos, and it conditions the generation on them. That's powerful, and also a wiring nightmare in a big builder workflow - nine image sockets plus three video sockets plus three audio sockets is a lot of dangling cables. VRGDG MiniMax H3 Reference Media From Paths is the pack's "builder-friendly" answer: type (or paste) the file paths, and it loads and sorts the media into the right H3 reference slots for you, returning None for any slot you didn't use.

How it works

Two text inputs, both multiline. image_paths accepts up to nine reference images - as a JSON list, as an object with image_paths/images keys, or simply one path per line. video_references accepts up to three reference videos, either as a JSON list of paths or as objects that can carry path, start_seconds, duration, and use_audio - which is how you grab a specific segment of a longer video instead of always using its head.

The outputs are the payoff. Nine ref_image_0 … ref_image_8 sockets, three ref_video_0 … ref_video_2 sockets, and three ref_video_audio_0 … ref_video_audio_2 sockets - one for each reference video's audio track, which H3 can use for audio conditioning and lipsync. The crucial detail is the ordering: the tooltip is explicit that these are ordered references, so position in your list maps directly to which H3 reference slot it lands in. If image #2 in your list is the character's face, that face is ref_image_1 - get the order wrong and the model will mix up who's who.

Unused slots return None, which is the builder-friendly bit: you can wire the full set of outputs once and leave the empties dangling without the graph erroring out.

The inputs that matter

• image_paths - up to 9, ordered; one per line or JSON.
• video_references - up to 3, ordered; add start_seconds/duration to trim, use_audio to pull the track.

Install

Pack-wide: ComfyUI Manager → search vrgamedev (or add https://github.com/vrgamegirl19/comfyui-vrgamedevgirl), restart, hard-refresh. Manual: git clone https://github.com/vrgamegirl19/comfyui-vrgamedevgirl into custom_nodes, pip install -r requirements.txt; Windows portable needs Cython + scikit-build-core installed first.

Troubleshooting

Path problems are the top of the list. These are filesystem paths - relative ones resolve against ComfyUI's input directory, and a typo returns an empty slot rather than an error, so a missing reference can silently change a generation. JSON syntax errors are the other classic; if you're hand-writing the video list, use one path per line instead until the start_seconds/duration trimming is actually needed. And if your references come back out of order, it's your list's order, not the node - the mapping is positional by design.