MiniMax H3 Image • Advanced Combined Prepare
Text, image, and reference editing
- clip
- vae
- source_image
- reference_image_2
- reference_image_3
- reference_image_4
- reference_image_5
- reference_image_6
- reference_image_7
- reference_image_8
- reference_image_9
- positive
- h3_latent
- fitted_source
- requested_frames
- optimized_prompt
- run_info
If you've seen the Text to Image, Image to Image, and Reference Edit nodes in this pack and thought "that's three nodes I'll have to learn," H3ImagePrepare - "MiniMax H3 Image • Advanced Combined Prepare" - is the consolidation. It does all three conditioning paths in a single node, and it adds up to nine reference inputs on top. It's the one to reach for when you want a Swiss-army workflow or you're not sure yet which mode a job needs.
The mode switcher
The mode dropdown picks the path. Text to image and image to image use FL2VA; reference edit uses REF2VA. From there the node does the same heavy lifting every prepare node in this pack does: it rounds your canvas to H3's 32-pixel grid, builds the packed H3 audio/video latent containing the requested temporal packet, encodes any source or reference images through the VAE, and returns positive conditioning ready for the sampler.
One subtlety worth knowing: if you set image_to_image (FL2VA) with a one-frame profile, the node silently switches to REF2VA-style source conditioning. That's not a bug - FL2VA's frame-0 anchor would occupy the only output frame, which is impossible in a one-frame edit. Multi-frame image editing keeps the original FL2VA keyframe path.
Inputs that matter
The inputs, cut down to the ones you'll actually touch:
clip- the MiniMax H3 Qwen text/vision encoder (also used for reference images, which is why REF2VA needs it).mode,prompt,width/height- the basics.frame_preset-single image | 1 frame,recommended | 5 frames, or 9/13/20. The one-frame profile is meant for REF2VA and the experimental H3 image VAE; multi-frame profiles use the standard video VAE.preserve_strength- prompt-language preservation for edits. It is not denoise strength and doesn't touch the sampler schedule; a trap a lot of people fall into.source_fit-crop_center,contain_pad, orstretchfor fitting source/reference content to the canvas.- Optional:
vae(required for I2I and REF2VA since images must be encoded - T2I ignores it),source_image, andreference_image_2throughreference_image_9(REF2VA only; they're politely ignored in the other modes, andrun_infotells you when).
Outputs and two gotchas
The outputs are the same shape as the dedicated prepare nodes: positive goes to your sampler's positive input, h3_latent goes to the sampler and then to Exact Frame Decode, fitted_source is a preview of the source on the generation canvas, requested_frames feeds the decoder, and optimized_prompt + run_info show you exactly what the node did (including warnings like "source_image is connected but ignored in Text to Image mode").
Two things to remember. Each reference socket represents exactly one picture - if an upstream node sends an IMAGE batch, only its first image is used, so your <Picture N> numbering stays stable. And in REF2VA you must state the role of every connected picture explicitly in the prompt; the node optimizes wording, it can't guess roles.
Install
Install is the pack, nothing more exotic: ComfyUI Manager (search MiniMax H3 Image Studio) or git clone https://github.com/astropuzzo/ComfyUI-MiniMax-H3-Image-Studio.git into custom_nodes, then restart. Requires ComfyUI 0.30.0+ and the H3 model stack from the official ComfyUI MiniMax H3 guide - the pruned INT8 ConvRot diffusion model, Qwen text encoder, and the video VAE (the audio VAE is not needed; the latent carries audio metadata but this pack never decodes it to sound).
Inputs (20)
| Name | Type | Default | Description |
|---|---|---|---|
| clip | CLIP | MiniMax H3 Qwen text/vision encoder. | |
| mode | COMBO | Select the H3 conditioning path. T2I and I2I use FL2VA; Reference Edit uses REF2VA. | |
| prompt | STRING | Final still description or edit instruction. | |
| width | INT | 134432–16384 | Output canvas width. |
| height | INT | 76832–16384 | Output canvas height. |
| frame_preset | COMBO | recommended | 5 frames | H3 jointly denoises the entire temporal packet. The one-frame profile is intended for REF2VA and the experimental H3 image VAE. Multi-frame profiles remain available for the standard video VAE. |
| optimize_prompt | BOOLEAN | true | Adds still-image wording and, for edit modes, source-preservation instructions. |
| preserve_strength | FLOAT | 0.600–1 | Prompt-language preservation strength for I2I/REF2VA. This is NOT diffusion denoise strength and does not change the sampler schedule. |
| source_fit | COMBO | crop_center | How source/reference content is fitted to the generation canvas. |
| reference_size | COMBO | max_identity_2048 | REF2VA reference encoding size. max_identity_2048 keeps more source resolution when available and can cost more memory. |
| vaeopt | VAE | Required for Image to Image and Reference Edit because source/reference images must be encoded. Text to Image does not use it. | |
| source_imageopt | IMAGE | Required for I2I and REF2VA. If connected in T2I it is ignored and run_info reports that fact. | |
| reference_image_2opt | IMAGE | Optional REF2VA <Picture 2>; ignored outside Reference Edit. | |
| reference_image_3opt | IMAGE | Optional REF2VA <Picture 3>; ignored outside Reference Edit. | |
| reference_image_4opt | IMAGE | Optional REF2VA <Picture 4>; ignored outside Reference Edit. | |
| reference_image_5opt | IMAGE | Optional REF2VA <Picture 5>; ignored outside Reference Edit. | |
| reference_image_6opt | IMAGE | Optional REF2VA <Picture 6>; ignored outside Reference Edit. | |
| reference_image_7opt | IMAGE | Optional REF2VA <Picture 7>; ignored outside Reference Edit. | |
| reference_image_8opt | IMAGE | Optional REF2VA <Picture 8>; ignored outside Reference Edit. | |
| reference_image_9opt | IMAGE | Optional REF2VA <Picture 9>; ignored outside Reference Edit. |
Outputs (6)
| Name | Type | Description |
|---|---|---|
| positive | CONDITIONING | Positive H3 FL2VA or REF2VA conditioning for the sampler's positive input. |
| h3_latent | LATENT | Packed H3 audio/video latent containing the requested temporal image packet. |
| fitted_source | IMAGE | Source image fitted to the generation canvas; useful for preview and comparison in edit modes. |
| requested_frames | INT | Number of image frames that Exact Frame Decode should preserve and decode. |
| optimized_prompt | STRING | Final prompt after optional still-image and source-preservation optimization. |
| run_info | STRING | Mode, temporal packet, canvas, checkpoint expectations and recommended selection strategy. |