hf_mirrors/MiniMax-H3-Longvideos
Model Introduction
Files & versions
Analysis
You are visiting the mirror address of https://huggingface.co/Smite79/MiniMax-H3-Longvideos. The repo is synchronized in real-time and is only for mirror acceleration access.

Support me on Ko-fi

This node is a constant work in progress! If you are noticing bugs or features that do not work, please ensure that you are pulling the most recent version and updating your workflows.

H3-LongVideos

Long MiniMax-H3 video with synchronised audio from a single prompt, in ComfyUI.

H3 renders about 15 seconds at a time. This node turns a written scene into a chain of shots and joins them into one continuous video. Your text reaches the model word for word.

Install

Copy this folder into ComfyUI/custom_nodes/ and restart the ComfyUI server.

Requires ComfyUI 0.31+ with native MiniMax-H3 support (tested on 0.33).

What to load

UNETa MiniMax-H3 model — a hybrid fl2va/ref2va merge works best
CLIPH3's text encoder, loader type minimax
VAEthe H3 video VAE
audio VAEthe H3 audio VAE — a separate file, and it must be the converted one
UNETLoader ─┐                     images ─> Video Combine / Save Video
CLIPLoader ─┼─> H3 Long Videos ─> audio  ─┘
VAELoader ──┘                     info   ─> Show Text

prompt is an input socket — wire a multiline text node into it.

Set plan_only first. It reports the shot split, the lengths and every warning, without rendering.

Writing the prompt

One paragraph = one shot, separated by a blank line. The first paragraph is the scene, prepended to every shot; the rest are beats.

Natural daylight, hard sun. A farm with a barn.

Dom drives a van down the driveway and stops in front of the barn.

Dom gets out and walks to the back of it.

Mara steps out of the barn and asks him: "Is that the last one?"

Dialogue goes in double quotes. Use the anchor widget if you want the framing carried separately — then every paragraph is a beat.

The character sheet

A paragraph of Name: attributes lines, or the character_memory widget. Each shot is given the entries for the people its beat names, and nobody else.

Nora: <Picture 1>, 34, she, tall, red hair, green canvas jacket, brown boots.
Mike: he, 41, dark hair, navy overalls.
  • Declare a pronoun. It is what lets "he takes her coat off" find the right two people.
  • One name per person. Dan in some beats and Mike in others reads as two.
  • Every name needs an entry, or the model invents that person differently each shot.

<Picture N> means ref_image_N, the socket. Tag it onto the person or thing it depicts and it follows them; untagged, a reference goes on every shot.

Settings

settingvalue
cfg1.0 — H3 is CFG-free; the negative prompt is never evaluated
sampler_nameres_multistep, or euler with PDD Acc
schedulersimple
shift_video / shift_audio12 / 3 — keep them near 4:1 or the audio breaks
steps6–8 with a turbo/distill LoRA, 20+ without
megapixels1.0 is H3's native budget; lower is faster and leaner
shot_secondsthe cap on each shot
shot_lengthfrom the beat sizes each shot from its own line; fixed gives every shot shot_seconds
ambient_levelambience under the whole soundtrack, built from your scene. 0 is off; 0.15–0.3 is a bed you notice only when it stops
ambient_audiooptional — wire a recording to use instead of the built one

Ambience is mixed, never prompted. Scoring a silent shot from text needs the audio branch left open, and an open branch on a joint model invents a voice for the face to lip-sync to. The bed is built from the room your scene names, so it needs no file, and shaped noise cannot speak. It makes tone — air, rumble, hum, water, a clock — so a scene whose ambience is birdsong gets the room, not the birds; info says when.

Everything else is a switch, on by default, and each has a tooltip explaining what it does and what it costs. Hover before you change one.

Outputs

slotwhat it is
imagesthe finished frames
audiothe synchronised soundtrack
infowhat the node did, and every warning — read this
scriptthe exact per-shot text it sent
frames_per_shot, total_frames, shots, video_secondsfor downstream nodes

When a shot renders something you did not expect, read script. It shows precisely what that shot was told, and info says why.

Other nodes here

  • H3 Shot Length — seconds to a valid H3 frame count.
  • H3 Overlay — watermark and intro title composited onto finished frames.
  • H3 Model Inspector — checkpoint precision, and whether your card runs it natively.

Notes

  • No negative prompt: H3 is CFG-free at cfg 1.
  • No denoise control: fixed at 1.0, because partial denoise desyncs the joint audio/video schedule.
  • Widgets are restored by position. If they read NaN, right-click the node → Fix node (recreate), set your values, and save the workflow again.

Disclaimer

The owner of this repo will not be responsible for any copyright strikes incurred because of use. You are responsible for your works. Use this node responsibly and ethically.