Nodes/MiniMax H3 Combined Image And Reference to Video/MiniMax H3 Combined Image And Reference to Video
ComfyUI Node
MiniMax H3 Combined Image And Reference to Video
Combined fl2va + ref2va conditioning for MiniMax H3. Supports first/middle/last target keyframes AND <Picture i> / <Video k> / <Audio j> references in the same conditioning payload.
MiniMax H3 Combined Image And Reference to Video
- clip
- vae
- audio_vae
- first_frame
- middle_frame
- last_frame
- ref_images
- ref_videos
- ref_video_audios
- ref_audios
- positive
- LATENT
◄prompt—►
◄resolution_sourceuse provided width and height values►
◄width1344►
◄height768►
◄length124►
◄reference_resize_moderesize to start frame total_pixels►
Categorymodel/conditioning/minimax
Inputs (16)
| Name | Type | Default | Description |
|---|---|---|---|
| clip | CLIP | — | |
| vae | VAE | — | |
| audio_vae | VAE | — | |
| prompt | STRING | MiniMax H3 prompt guide. Use reference tags to point the prompt at supplied media, for example <Picture 1>, <Picture 2>, <Video 1>, <Audio 1>, and structured subject labels such as <Subject 1>, <Subject 2>. Keep numbering consistent with the order of the corresponding references. Recommended prompt sections depend on the generation mode: 1. T2VA / I2VA / FL2VA / L2VA integrated_multimodal_description → overall_soundscape → non_diegetic_music Use integrated_multimodal_description for the main visual action, subjects, camera, timing, environment, and any image/video references. Use overall_soundscape for diegetic/environmental sound and dialogue. Use non_diegetic_music for score or background music. 2. Full-reference Ref2VA subject_definitions → summary → retention_analysis → detailed_description → overall_soundscape → non_diegetic_music Use subject_definitions to establish referenced subjects and their identities with tags such as <Subject 1>. Use summary for the overall shot intent. Use retention_analysis to state which reference traits, identity, appearance, motion, voice, or other characteristics should be retained. Use detailed_description for the full scene, action, camera, timing, and reference usage. Finish with overall_soundscape and non_diegetic_music for audio. | |
| resolution_source | COMBO | use provided width and height values | Chooses the generation resolution and, for source-resize modes, how first_frame / middle_frame / last_frame are fitted. • use width and height of source image first — first checks first_frame, then middle_frame, then last_frame. If none are connected, falls back to the first visual reference, then provided width/height. • use width and height of reference image first — first checks ref_images, then ref_videos. If none are connected, falls back to source frames, then provided width/height. • use provided width and height values — original behavior. • resize source (keep aspect ratio, fit mode: total pixels) — use the first connected source guide as the aspect-ratio anchor and resize it so its total pixel area matches the provided width × height area. May upscale or downscale. • resize source (keep aspect ratio, fit mode: shortest edge) — resize the source so its shortest edge matches the shortest provided edge. May upscale or downscale. • resize source (keep aspect ratio, fit mode: longest edge) — resize the source so its longest edge matches the longest provided edge. May upscale or downscale. • resize source (fit mode: stretch) — use the provided width/height canvas and stretch connected source guides to it. For the three aspect-ratio source modes, the first connected source guide (first_frame → middle_frame → last_frame) determines one shared generation canvas; all connected source guides are aspect-preserving cover-fitted into that canvas. Final width and height are always corrected to multiples of 32. |
| width | INT | 134432–16384 | — |
| height | INT | 76832–16384 | — |
| length | INT | 1241–3600 | Frame count. length=1 uses the confirmed single-frame MiniMax H3 path (video latent T=1) for T2I / I2I / Ref2I workflows. At length=1, any connected first_frame, middle_frame, and last_frame guides all resolve to target frame 0 and are passed through independently without deduplication. All other lengths use stock ComfyUI MiniMax H3 latent creation and normal frame-grid snapping. |
| reference_resize_mode | COMBO | resize to start frame total_pixels | How reference images are resized before MiniMax H3 reference encoding. Aspect ratio is always preserved and references are never upscaled. • resize to frame short edge — downscale until the reference short edge fits the generated frame short edge. Useful for keeping reference detail roughly bounded by the smaller frame dimension. • resize to start frame long edge — downscale until the reference long edge fits the generated/start-frame long edge. Useful for a stricter fit when the reference and target have different aspect ratios. • resize to start frame total_pixels — downscale by total pixel area so the reference uses about the same image-token/latent area as one generated frame. This is the former 'match' mode. • resize MiniMax H3 2k resolution — keep the reference as large as possible, only downscaling when its short edge exceeds MiniMax H3's 2048 px reference limit. This is the former 'max' mode and can be significantly slower. |
| first_frameopt | IMAGE | Optional opening keyframe, conditioned at target frame 0. At length=1 it shares frame 0 with any connected middle_frame and/or last_frame guides. | |
| middle_frameopt | IMAGE | Optional middle target keyframe. It is conditioned at approximately half the generated clip: exact 0-based index frame_count // 2. For example, 124 output frames place it at frame 62 (~2.58 s at 24 fps). The image is aspect-preserving cover-cropped to the output canvas. Current ComfyUI H3 supports arbitrary target keyframe indices natively; this node also includes a compatibility layout repair for older H3 cores that only accepted endpoints. At length=1 this guide resolves to frame 0 and is not treated as an interior guide. | |
| last_frameopt | IMAGE | Optional ending keyframe, conditioned at target frame frame_count - 1. At length=1 this is frame 0, shared with any other connected target guides. | |
| ref_imagesopt | COMFY_AUTOGROW_V3 | — | |
| ref_videosopt | COMFY_AUTOGROW_V3 | — | |
| ref_video_audiosopt | COMFY_AUTOGROW_V3 | — | |
| ref_audiosopt | COMFY_AUTOGROW_V3 | — |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| positive | CONDITIONING | — |
| LATENT | LATENT | — |