All local H3 guides
Setup guide / Local H3

How to run MiniMax H3 in ComfyUI

Install and run MiniMax H3 in ComfyUI with native T2V, I2V, and R2V workflows, correct model folders, resolution settings, and first-run checks.

Reviewed
2026-08-09
Reading time
8 min
Evidence
2 official / 0 community
Short answer

Update to ComfyUI 0.30.0 or later, open Template Library > Video, and choose a MiniMax H3 T2V, I2V, or R2V workflow. Let the template download the matching diffusion model, Qwen3-VL text encoder, video VAE, and audio VAE. Start below native resolution, then move to a 768-pixel short edge after the complete video-and-audio path works.

01

Start from a native template

Update ComfyUI, restart it, then open the template library and search for MiniMax H3. Choose T2V for a text-only test, I2V when one or two keyframes control the clip, or R2V when references control identity, style, motion, camera, or voice. The templates are a safer first run than assembling the graph from memory because they connect H3-specific video and audio components correctly.

  • T2V and I2V share the FL2VA diffusion weights.
  • R2V uses the separate Ref2VA diffusion weights.
  • All three workflows require the text encoder, visual VAE, and audio VAE.
02

Check the model folders

The current ComfyUI templates use pruned INT8 H3 diffusion weights and a quantized Qwen3-VL encoder distributed through the Comfy-Org model repository. These filenames differ from the original BF16 checkpoint layout on the MiniMax repository.

ComfyUI/
└── models/
    ├── diffusion_models/
    │   └── minimax_h3_fl2va_pruned_int8_convrot.safetensors
    ├── text_encoders/
    │   └── qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors
    └── vae/
        ├── minimax_h3_video_vae_fp16.safetensors
        └── minimax_h3_audio_vae_fp32.safetensors
03

Use a conservative first run

Keep the default fast preview resolution for the first request. Use a short text-only prompt, one output, and the template step count. Confirm that ComfyUI produces a playable MP4 with synchronized audio before increasing dimensions or duration.

  • Keep width and height on the 32-pixel grid used by H3.
  • After the preview succeeds, target about 1.0 megapixel at 16:9, roughly 1344 x 768.
  • H3 duration follows its frame-block grid at 24 fps, so the rendered length may not equal a hand-entered decimal exactly.
  • Watch the console during model swaps; low-VRAM systems may spend more time moving weights than denoising.
04

Add image or reference conditioning

For I2V, connect a first frame, a last frame, or both to the MiniMax H3 image-to-video node. For R2V, connect materials in a stable order and name them by the same one-based order inside the prompt. Give each item one explicit job.

InputPrompt role exampleCommon failure
Picture 1Owns character identityCompetes with another face reference
Video 1Owns movement and camera rhythmAccidentally becomes the visual style
Audio 1Owns the speaking voiceDialogue is too long for the shot
05

Speed tuning comes after a baseline

ComfyUI documents an optional SageAttention path through either a KJNodes patch node or the global --use-sage-attention flag. Install only a wheel that matches the active Python, PyTorch, CUDA, and GPU architecture. Save a baseline clip before enabling it, then compare generation time, faces, fine motion, text, and stereo audio with the same seed.

Frequently asked questions
Does ComfyUI support MiniMax H3 natively?

Yes. ComfyUI documents native MiniMax H3 nodes and templates for text-to-video, image-to-video, and reference-to-video in version 0.30.0 or later.

Where do MiniMax H3 model files go in ComfyUI?

The diffusion model goes in models/diffusion_models, the Qwen3-VL encoder in models/text_encoders, and both the video and audio VAEs in models/vae.

Which model is used for MiniMax H3 image-to-video?

The T2V and I2V templates use the FL2VA diffusion model. Reference-to-video uses the separate Ref2VA diffusion model.

Can SageAttention make MiniMax H3 faster in ComfyUI?

ComfyUI documents SageAttention as an optional speed path and says it can roughly double generation speed with minimal quality loss, but compatibility depends on matching PyTorch, CUDA, and wheel versions.

Sources and evidence

Read the original material

Community figures describe the named machine and workflow only. They are not MiniMax performance guarantees.

  1. Official documentationComfyUI MiniMax H3 workflow guide
  2. Official documentationMiniMax H3 model card