Download MiniMax H3
MiniMax H3 is available as open weights from MiniMax's official Hugging Face repository. You do not need to download every H3 checkpoint: choose FL2VA for text-to-video and first/last-frame generation, or choose Ref2VA for multimodal reference-to-video.
Last verified: August 8, 2026
Quick Answer
MiniMax H3's official repository contains two task-specific open-weight families: FL2VA and Ref2VA. Download FL2VA if you want text-to-video or first-frame, last-frame, or first-and-last-frame image-to-video. Download Ref2VA if you want reference-to-video using images, videos, audio, character identity, motion, camera behavior, or voice references. You only need both checkpoint families if you intend to use both kinds of workflow. Diffusers users do not need to manually download the entire repository because MiniMax's documented ModularPipeline workflow fetches the components it needs.
MiniMax H3 Download at a Glance
| Goal | Download |
|---|---|
| Text-to-video | FL2VA |
| First-frame image-to-video | FL2VA |
| Last-frame image-to-video | FL2VA |
| First + last frame | FL2VA |
| Reference images | Ref2VA |
| Character identity reference | Ref2VA |
| Reference video | Ref2VA |
| Motion or camera reference | Ref2VA |
| Audio / voice reference | Ref2VA |
| All H3 workflow families | FL2VA + Ref2VA |
| ComfyUI | Comfy-Org optimized H3 files |
| Diffusers | Load required components through ModularPipeline |
| SGLang / vLLM | Original MiniMax task-family checkpoint structure |
For most users, "download MiniMax H3" should not mean "download everything." First decide whether the job belongs to FL2VA, Ref2VA, or both.
Official MiniMax H3 Download
The primary official source for MiniMax H3 open weights is the MiniMaxAI/MiniMax-H3 repository on Hugging Face. The repository contains the original task-family checkpoints and Diffusers-compatible components.
Official MiniMax source
Download MiniMax H3 from Hugging FaceWhat Is MiniMax H3 FL2VA?
FL2VA is the MiniMax H3-Base checkpoint family for text-to-audio-video and first/last-frame-to-audio-video generation. With no image input, it works as text-to-video. With one image, the workflow can use that image as a first or last frame. With two images, it can condition the generation on both a first and a last frame.
Download FL2VA if your main goal is T2V or I2V.
| Input | FL2VA behavior |
|---|---|
| 0 images | Text-to-video |
| 1 image | First-frame or last-frame generation |
| 2 images | First-and-last-frame generation |
What Is MiniMax H3 Ref2VA?
Ref2VA is the H3-Base checkpoint family for multimodal reference-to-audio-video generation. It accepts text together with reference images, videos, and/or audio and is designed for workflows that need information such as character identity, visual style, motion, camera behavior, or voice from reference material.
Download Ref2VA if the new video needs to borrow information from reference media rather than simply start or end from one or two keyframes.
FL2VA vs Ref2VA: Which MiniMax H3 Model Should You Download?
| Requirement | FL2VA | Ref2VA |
|---|---|---|
| Text-to-video | Yes | Not required |
| First-frame I2V | Yes | Not primary purpose |
| Last-frame I2V | Yes | Not primary purpose |
| First + last frame | Yes | Not required |
| Character reference | No dedicated reference mode | Yes |
| Multiple reference images | No dedicated reference mode | Yes |
| Video reference | No | Yes |
| Motion reference | No | Yes |
| Camera reference | No | Yes |
| Voice/audio reference | No | Yes |
| Native generated audio | Yes | Yes |
Simple rule: start with FL2VA for normal T2V and I2V. Add Ref2VA only when you need H3's multimodal reference workflow.
Download Only FL2VA
If you only need text-to-video or image-to-video, scope the Hugging Face download to FL2VA instead of downloading both task families.
Terminal
hf download MiniMaxAI/MiniMax-H3 \
--include "model_index.json" "FL2VA/*" \
--local-dir MiniMax-H3This downloads the repository-level model index and the FL2VA task family without intentionally including the separate Ref2VA checkpoint family.
Download FL2VA and Ref2VA
If you need both base generation and multimodal reference generation, download both task families.
Terminal
hf download MiniMaxAI/MiniMax-H3 \
--include "model_index.json" "FL2VA/*" "Ref2VA/*" \
--local-dir MiniMax-H3Do not use the two-family command simply because it looks more complete. If your deployment only needs one workflow family, the scoped single-family download is the cleaner choice.
What Is Inside Each H3 Checkpoint Family?
Each MiniMax H3 task-specific checkpoint is distributed as a self-contained Hugging Face-style model structure containing the processor, tokenizer, text encoder, Omni Transformer, visual VAE, and audio VAE required by that task family.
Checkpoint structure
<TASK>/
├── model_index.json
├── processor/
├── tokenizer/
├── text_encoder/
├── transformer/
├── visual_vae/
└── audio_vae/<TASK> is FL2VA or Ref2VA.
Do Diffusers Users Need to Download MiniMax H3 Manually?
Not necessarily. MiniMax's official H3 documentation states that Diffusers users can load the model through ModularPipeline.from_pretrained("MiniMaxAI/MiniMax-H3"), which fetches the components required by the pipeline. A full manual mirror of the repository is therefore not a prerequisite for the documented Diffusers workflow.
Python
ModularPipeline.from_pretrained("MiniMaxAI/MiniMax-H3")Use a manual scoped download when your deployment or storage workflow requires local checkpoint files; otherwise, follow the framework's documented loading path.
MiniMax H3 Download for ComfyUI
ComfyUI users should use the ComfyUI-compatible H3 files rather than blindly treating the original Hugging Face checkpoint directory as a ComfyUI model folder.
T2V / I2V
Diffusion:
minimax_h3_fl2va_pruned_int8_convrot.safetensors
R2V
Diffusion:
minimax_h3_ref2va_pruned_int8_convrot.safetensors
Shared
Text encoder:
qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors
Video VAE:
minimax_h3_video_vae_fp16.safetensors
Audio VAE:
minimax_h3_audio_vae_fp32.safetensors
What You Do NOT Need to Download
Choosing what not to download is just as important as finding the model repository.
If you only use text-to-video
You do not need the Ref2VA diffusion checkpoint. Start with FL2VA.
If you only use first-frame or first/last-frame image-to-video
You still use FL2VA. Ref2VA is not required for normal first/last-frame conditioning.
If you only use reference-to-video
Use Ref2VA. Add FL2VA only if you also want T2V or first/last-frame generation.
If you use ComfyUI
Use the ComfyUI-compatible files and native H3 templates. Do not download the complete original checkpoint tree simply to make a standard ComfyUI workflow work.
If you use Diffusers
Use the documented ModularPipeline loading workflow unless your environment specifically requires a manual local model mirror.
MiniMax3.org download rule: choose the workflow first, then download the model family. Do not choose the largest download simply because it appears more complete.
Can You Download the Complete MiniMax H3 2K Pipeline?
Not as a completely open local stack today. MiniMax describes the complete H3 system as H3-Context-IR → H3-Base → H3-Regenerate-2K. H3-Base is released as open weights and produces the 768p base audiovisual result. H3-Context-IR is a hosted preprocessing and orchestration system. H3-Regenerate-2K regenerates the base result at 2K using the original context, and MiniMax currently states that this module is not yet open-sourced.
Downloading FL2VA or Ref2VA therefore gives you an H3-Base checkpoint family; it is not the same as downloading every component of MiniMax's complete official 2K generation pipeline.
H3-Context-IR
↓
H3-Base
↓
768p base result
↓
H3-Regenerate-2K
↓
2K resultMiniMax H3 Model Specifications
| Specification | MiniMax H3 |
|---|---|
| Developer | MiniMax |
| Open-weight model | H3-Base |
| H3-Base checkpoint families | FL2VA and Ref2VA |
| Output duration | 4–15 seconds |
| Default short edge | 768 pixels |
| Frame rate | 24 FPS |
| Audio output | 32 kHz stereo |
| Full system maximum resolution | Up to 2K |
| 2K mechanism | H3-Regenerate-2K |
| License | MiniMax H3 Community License Agreement |
The phrase "up to 2K" describes the complete MiniMax H3 system. Do not interpret it as evidence that every open-weight H3-Base deployment automatically produces the complete official 2K workflow locally.
MiniMax H3 Reference Input Limits
| Input | Limit |
|---|---|
| Reference images | ≤ 9 |
| Reference videos | ≤ 3 |
| Each video | 2–15 seconds |
| Total reference video duration | ≤ 15 seconds |
| Reference audio clips | ≤ 3 |
| Each audio clip | 2–15 seconds |
| Total reference audio duration | ≤ 15 seconds |
| Maximum mixed reference files | 12 |
Reference audio cannot be the sole Ref2VA input. The official H3 specification requires audio references to be accompanied by image or video input.
Is MiniMax H3 Free to Download?
MiniMax H3 open weights are publicly downloadable from the official Hugging Face repository, but "downloadable" does not mean "free of all conditions." The model is distributed under the MiniMax H3 Community License Agreement.
Before commercial deployment, redistribution, hosted-service use, or other production use, read the current official license terms that apply to your project.
Official MiniMax H3 Download Sources
MiniMaxAI/MiniMax-H3
Official MiniMax repository containing the H3 model card, original FL2VA and Ref2VA checkpoint families, deployment instructions, model specification, full 2K workflow explanation, and license.
Comfy-Org/MiniMax-H3
ComfyUI-compatible MiniMax H3 model files used by the native ComfyUI workflows.
Official ComfyUI MiniMax H3 Guide
Official ComfyUI instructions for H3 T2V, I2V and R2V workflows, filenames, folders, resolution settings and reference behavior.
MiniMax H3 Download FAQ
Where can I download MiniMax H3?
Download the official H3 open weights from the MiniMaxAI/MiniMax-H3 repository on Hugging Face.
Which MiniMax H3 model should I download for text-to-video?
Download FL2VA. It is the H3-Base checkpoint family for text-to-video and first/last-frame generation.
Which MiniMax H3 model should I download for reference-to-video?
Download Ref2VA when you need references such as images, video, motion, camera behavior, character identity, or voice.
Do I need both FL2VA and Ref2VA?
No. Download both only if your workflow needs both base T2V/I2V generation and multimodal reference-to-video.
Does MiniMax H3 have open weights?
Yes. MiniMax publishes the H3-Base FL2VA and Ref2VA task-specific checkpoint families as open weights.
Do Diffusers users need to download the whole H3 repository?
No. MiniMax’s documented Diffusers ModularPipeline workflow can fetch the required components through from_pretrained instead of requiring a full manual repository download.
Can I download the full MiniMax H3 2K system and run it entirely locally?
Not as a fully open local stack today. H3-Base is open weight, while H3-Context-IR is hosted and MiniMax currently states that H3-Regenerate-2K is not yet open-sourced.
Is MiniMax H3 free to download?
The H3 open weights are publicly downloadable, but use remains subject to the MiniMax H3 Community License Agreement and the compute or infrastructure costs of running the model.
Use MiniMax H3 Without Downloading Models
If you want to generate with MiniMax H3 without managing local checkpoints, model directories, Python environments, or GPU configuration, use the browser-based generator.