- Text-to-Video (T2V): Generate videos from text prompts
- Image-to-Video (I2V): Generate videos from an input image, with optional first/last-frame control
- Reference-to-Video (R2V): Generate videos that lock in a character, style, motion, camera move, or voice from reference images, videos, and audio
MiniMaxH3ImageToVideo node, and reference-driven generation with images, videos, and audio (ref2va) via the MiniMaxH3ReferenceToVideo node. You can build additional workflows with these nodes.
Key features
- Native stereo audio: Dialogue, sound effects, and music are generated together with the video, synced in one MP4
- Multimodal context: Text, images, video, and audio references can be combined in one generation
- Reference-driven generation: Lock a character’s identity, a style, a motion, a camera move, or a voice from reference materials
- Instruction following: Describe the relationship between references and the target shot in natural language
- Accurate text rendering: Spelled-out text and brand elements render cleanly
- Open weights: Run locally in ComfyUI with full control over every parameter
Getting started
MiniMax H3 is supported in ComfyUI with open weights. To get started:- Update ComfyUI to version 0.30.0 or later
- Go to Template Library > Video > choose any MiniMax H3 workflow
- Follow the pop-up to download models and run the workflow
Setting the output resolution
Each workflow uses a Resolution Selector node to control the overall output size. The node computeswidth and height from three settings, and its outputs connect directly to the width and height inputs of the MiniMax H3 node:
- Aspect ratio: Pick a preset such as
16:9 (Widescreen),9:16 (Portrait Widescreen), or1:1 (Square) - Megapixels: Target total pixel count for the output. Higher values give larger frames; lower values run faster
- Multiple: The computed resolution is rounded to the nearest multiple of this number. Keep it at
32to match H3’s resolution grid
1.0 at 16:9, which yields roughly 1344x768: H3’s native canvas, a 768px short edge capped at 768x1344 pixels.
ComfyUI Native Workflows
MiniMax H3 Text to Video (T2V)
Generate videos from text prompts with native stereo audio.Run in Comfy Cloud
Open in Comfy Cloud
Download Workflow
Download JSON or search “MiniMax H3 T2V” in Template Library
Model downloads
Diffusion Model: minimax_h3_fl2va_pruned_int8_convrot
Place in
ComfyUI/models/diffusion_models/Text Encoder: qwen3vl_32b_minimax_h3_nvfp4_awq
Place in
ComfyUI/models/text_encoders/VAE: minimax_h3_video_vae_fp16
Place in
ComfyUI/models/vae/VAE: minimax_h3_audio_vae_fp32
Place in
ComfyUI/models/vae/Model storage
Prompting tips
- Describe the whole scene: State the overall scene first (location, character, what is happening), then break it into timed shots
- Shots, camera, and audio: Describe the shots, camera moves, and the accompanying audio (dialogue, SFX, music) in one prompt block
- Resolution: H3’s native canvas is a 768px short edge, capped at 768x1344 pixels and rounded to a multiple of 32
- Duration: The duration input snaps to the model’s 17-frame-per-block (17k+5) grid at 24fps
- First/last frame: Connect images to
first_frameand/orlast_frameon theMiniMaxH3ImageToVideonode to turn this workflow into first/last-frame image-to-video
Prompt writing guide
MiniMax publishes an official video prompt writing guide for the base generation modes: T2VA, I2VA, FL2VA, and L2VA. The guide explains how to structure a prompt into timed shots with camera movement and audio (dialogue, SFX, music), and includes examples for each mode.MiniMax H3 Image to Video (I2V)
Generate videos from an input image, with optional first/last-frame keyframes.Run in Comfy Cloud
Open in Comfy Cloud
Download Workflow
Download JSON or search “MiniMax H3 I2V” in Template Library
Input Image: transparent_rgb_gaming_mouse.png
Download the default input image, or use your own image.
Model downloads
Diffusion Model: minimax_h3_fl2va_pruned_int8_convrot
Place in
ComfyUI/models/diffusion_models/Text Encoder: qwen3vl_32b_minimax_h3_nvfp4_awq
Place in
ComfyUI/models/text_encoders/VAE: minimax_h3_video_vae_fp16
Place in
ComfyUI/models/vae/VAE: minimax_h3_audio_vae_fp32
Place in
ComfyUI/models/vae/Model storage
Prompting tips
- Keyframes: The
first_frameandlast_frameinputs are optional; the model generates the motion between them - Prompt: Describe the shots, motion, and the accompanying audio (dialogue, SFX, music) in one block
- Resolution: H3’s native canvas is a 768px short edge, capped at 768x1344 pixels and rounded to a multiple of 32
- Duration: The duration input snaps to the model’s 17-frame-per-block (17k+5) grid at 24fps
Prompt writing guide
MiniMax publishes an official video prompt writing guide for the base generation modes: T2VA, I2VA, FL2VA, and L2VA. The guide explains how to structure a prompt into timed shots with camera movement and audio (dialogue, SFX, music), and includes examples for each mode.MiniMax H3 Reference to Video (R2V)
Generate videos that lock in a character, style, motion, camera move, or voice from any mix of reference images, videos, and audio.Run in Comfy Cloud
Open in Comfy Cloud
Download Workflow
Download JSON or search “MiniMax H3 R2V” in Template Library
Reference Image: red_superboy_on_city_roof.png
Character reference for the workflow, or use your own images.
Reference Image: mecha_dragon_lightning.png
Style and subject reference for the workflow, or use your own images.
Model downloads
Diffusion Model: minimax_h3_ref2va_pruned_int8_convrot
Place in
ComfyUI/models/diffusion_models/Text Encoder: qwen3vl_32b_minimax_h3_nvfp4_awq
Place in
ComfyUI/models/text_encoders/VAE: minimax_h3_video_vae_fp16
Place in
ComfyUI/models/vae/VAE: minimax_h3_audio_vae_fp32
Place in
ComfyUI/models/vae/Model storage
Prompting tips
- Reference by tag: Reference each input by tag in the exact order it was connected, for example
<Picture 1>,<Video 1>,<Audio 1> - Assign each reference a job: State which reference drives which part of the shot (identity, style, motion, camera, voice). Explicit assignments tend to work much better
- Limits: Up to 9 reference images, 3 reference videos (each can carry its own soundtrack), and 3 standalone reference audio clips
- ref_image_size:
matchscales references down to the generation resolution for speed;maxkeeps up to a 2048px short edge for stronger identity fidelity at the cost of speed - Note: R2V uses the
ref2vadiffusion model, a different set of weights from thefl2vamodel used by the T2V and I2V workflows
Prompt writing guide
MiniMax publishes an official full-reference mode prompt guide for reference-driven generation (R2V). The guide covers the rewrite output structure, including subject definitions, reference labels, and retention analysis, and how to assign each reference a role in the target shot.Speeding up generation with Sage Attention
The example workflows use the standard attention implementation. You can roughly double the generation speed with Sage Attention, with minimal quality loss. Sage Attention is an optional dependency, so you need to install it yourself:- Install the
sageattentionPython package. Download the wheel that matches your PyTorch and CUDA versions from the SageAttention releases page, then install it withpip install <wheel-file>. - Install the KJNodes custom nodes, which provide the
Patch Sage Attention KJnode. Use the ComfyUI Manager, or clone the repository intoComfyUI/custom_nodes/and restart ComfyUI. - Add a
Patch Sage Attention KJnode to the workflow and connect it between theUNETLoaderand theBasicGuidernode: itsmodelinput receives the model from theUNETLoader, and itsmodeloutput feeds themodelinput of theBasicGuider. Setsage_attentiontoauto. - Run the workflow as usual. Only the guider needs the patch; the scheduler only generates the sigmas and can stay as is.
- Sage Attention requires float16 or bfloat16 tensors. MiniMax H3 runs some layers in other dtypes, so you may see “Input tensors must be in dtype of torch.float16 or torch.bfloat16, using pytorch attention instead” messages in the console. These are expected; the affected layers fall back to standard attention and generation still works.
- Alternatively, you can enable Sage Attention globally by launching ComfyUI with the
--use-sage-attentionflag instead of adding the node.