MiniMax H3 Director Planner Conditioning
Same conditioning, plus a note about what mode you're in
- clip
- vae
- audio_vae
- first_frame
- last_frame
- reference_image_0
- reference_image_1
- reference_image_2
- reference_image_3
- reference_image_4
- reference_image_5
- reference_image_6
- reference_image_7
- reference_image_8
- positive
- latent
- task_mode
MiniMax H3 Director Planner Conditioning is the Director Conditioning node with one extra output, and that one output tells you something the plain version keeps to itself: which mode H3 actually resolved your inputs into. Where its sibling just produces conditioning and walks away, this node adds a third task_mode output - a short string like r2v - Reference to Video (MiniMax H3) (~2 ref image(s)) - so a planning layer downstream can see what the graph is doing.
Everything else about the inputs is identical to MiniMax H3 Director Conditioning: clip, vae, prompt, width, height, length, optional audio_vae, first_frame/last_frame keyframes, up to nine reference_image_N slots, and ref_image_size (match/max). No task-type dropdown here either - the node watches what's connected and infers. Reference images present → it runs H3's MiniMaxH3ReferenceToVideo path (and demands the audio_vae); otherwise it runs MiniMaxH3ImageToVideo. The task_mode output is just that inference, reported honestly, including a reference count when one applies.
Why the extra output exists
H3 is a chameleon: the same prompt, width, height, and length describe a text-to-video clip if nothing else is plugged in, an i2v/fl2v clip if keyframes are, and an r2v clip if reference images are. When you're scripting a graph from another node - a planner, an LLM prompt-routing setup, anything that builds clips on the fly - you need to know which family the conditioning landed in so you can pick the matching UNET and decode path downstream. That's this node's reason to exist: it surfaces the mode decision as data you can branch on, instead of leaving it implicit.
It's also a decent sanity check during setup. Wire one up, queue once, and read task_mode to confirm your reference images actually pushed the graph into reference territory rather than silently producing a plain t2v clip.
Outputs
positive (CONDITIONING) and latent (LATENT) feed a KSampler on the H3 UNET with a MiniMaxH3SigmaShift, exactly like the sibling node; task_mode (STRING) is the human-readable mode report for planning. The decode-side caveat carries over too - this node does conditioning, not the AV-latent separation that turns your sampled result into video plus stereo audio, so budget for that downstream if you're building a full graph.
If you're doing real multi-segment directing, though, step back and ask whether you need this at all. The Director node does conditioning, sampling, and decode per segment and hands you finished images and audio - it just doesn't expose the conditioning as reusable pieces. Planner Conditioning is the tool for people who need those pieces in the open. ComfyUI 0.30.0+ is required (it calls ComfyUI's official H3 nodes), and the H3 Community License territory restriction - US, EU, UK, South Korea - applies to whatever you generate with it.
Inputs (19)
| Name | Type | Default | Description |
|---|---|---|---|
| clip | CLIP | — | |
| vae | VAE | — | |
| prompt | STRING | — | |
| width | INT | 86432–8192 | — |
| height | INT | 48032–8192 | — |
| length | INT | 1245–3600 | — |
| audio_vaeopt | VAE | Required for r2v / v2v / rv2v / reference video+audio. | |
| first_frameopt | IMAGE | Optional first keyframe (i2v / fl2v). | |
| last_frameopt | IMAGE | Optional last keyframe (fl2v). | |
| reference_image_0opt | IMAGE | Reference image for <Picture 1> in prompt (r2v). Native aspect; H3 ref_image_size applies at encode time. | |
| reference_image_1opt | IMAGE | Reference image for <Picture 2> in prompt (r2v). Native aspect; H3 ref_image_size applies at encode time. | |
| reference_image_2opt | IMAGE | Reference image for <Picture 3> in prompt (r2v). Native aspect; H3 ref_image_size applies at encode time. | |
| reference_image_3opt | IMAGE | Reference image for <Picture 4> in prompt (r2v). Native aspect; H3 ref_image_size applies at encode time. | |
| reference_image_4opt | IMAGE | Reference image for <Picture 5> in prompt (r2v). Native aspect; H3 ref_image_size applies at encode time. | |
| reference_image_5opt | IMAGE | Reference image for <Picture 6> in prompt (r2v). Native aspect; H3 ref_image_size applies at encode time. | |
| reference_image_6opt | IMAGE | Reference image for <Picture 7> in prompt (r2v). Native aspect; H3 ref_image_size applies at encode time. | |
| reference_image_7opt | IMAGE | Reference image for <Picture 8> in prompt (r2v). Native aspect; H3 ref_image_size applies at encode time. | |
| reference_image_8opt | IMAGE | Reference image for <Picture 9> in prompt (r2v). Native aspect; H3 ref_image_size applies at encode time. | |
| ref_image_sizeopt | COMBO | match | Reference image sizing for MiniMaxH3ReferenceToVideo. |
Outputs (3)
| Name | Type | Description |
|---|---|---|
| positive | CONDITIONING | — |
| latent | LATENT | — |
| task_mode | STRING | — |