MiniMax-H3-Image-NVFP4
fast image generation up to 16.8 MP in ComfyUI
2 min readupdated
This is a 4-bit quantized version of MiniMaxAI/MiniMax-H3-Image built specifically for ComfyUI. It handles both text-to-image generation and reference-based image editing at high resolutions (up to 4096×4096) in just 6 steps. Based on Comfy-Org's 40.2 GB pruned bf16 checkpoint, 200 linear layers were converted to NVFP4 (4-bit quantization for the NVIDIA Blackwell architecture) without fine-tuning. This drops the file size to 12.5 GB, letting the model and its text encoder fit comfortably inside the RTX 5090's 32 GB of VRAM while running 2.1–2.4× faster than the original.
Key features
- Compact footprint: reduced from 40.23 GB to 12.54 GB by converting 200 layers to NVFP4 via ComfyUI's built-in quantizer.
- High speed: on an RTX 5090, generating a 4 MP frame (2048×2048 or 2720×1536) takes ~3 seconds, while 16.8 MP (4096×4096) takes ~16 seconds.
- Native integration: loads directly with standard
UNETLoaderandCLIPLoadernodes in ComfyUI—no custom nodes required. - Reference support: works for both text-to-image generation and reference-guided image editing.
What you can do
- Generate detailed images and posters with legible text at 4K and up to 16.8 megapixels without long wait times.
- Edit scenes using reference images (such as relighting a room from day to night in ~5.7 seconds).
- Run the heavy MiniMax H3-Image model locally on a single 32 GB VRAM GPU instead of 96 GB server accelerators.
Example
Place minimax_h3_image_pruned_nvfp4.safetensors into ComfyUI/models/diffusion_models/ and load it using UNETLoader (weight_dtype = default). Use the following KSampler settings for generation:
steps: 6
cfg: 1.0
sampler: euler
scheduler: simple
denonise: 1.0
positive: MiniMaxH3ImageConditioning (output 0)
negative: ConditioningZeroOut of the positive
Read more
DetailsRTX 5090 benchmarks (6 steps): 2.9–3.4 s for 4 MP, 7.2 s for 3840×2176, 15.7–16.6 s for 16.8 MP; cold start takes 13 s.
Requirements: NVIDIA Blackwell GPU (RTX 5090, peak VRAM 27.6–31.1 GB), ComfyUI 0.45+, and PyTorch 2.10 with CUDA 13 (
cu130).Separate files needed: a text encoder (such as the 15.7 GB
qwen3vl_32b_heretic_minimax_h3_nvfp4.safetensors) and VAE (minimax_h3_image_vae_fp16.safetensors).Limitations: using 3+ reference images causes noticeable composition drift compared to the bf16 original; the 2-step turbo LoRA was deemed too raw by the author; the license is not valid in the US, EU, UK, and South Korea.














Comments