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

What to download for each MiniMax H3 goal
GoalDownload
Text-to-videoFL2VA
First-frame image-to-videoFL2VA
Last-frame image-to-videoFL2VA
First + last frameFL2VA
Reference imagesRef2VA
Character identity referenceRef2VA
Reference videoRef2VA
Motion or camera referenceRef2VA
Audio / voice referenceRef2VA
All H3 workflow familiesFL2VA + Ref2VA
ComfyUIComfy-Org optimized H3 files
DiffusersLoad required components through ModularPipeline
SGLang / vLLMOriginal 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.

What 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.

FL2VA behavior by number of input images
InputFL2VA behavior
0 imagesText-to-video
1 imageFirst-frame or last-frame generation
2 imagesFirst-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?

FL2VA versus Ref2VA download requirements
RequirementFL2VARef2VA
Text-to-videoYesNot required
First-frame I2VYesNot primary purpose
Last-frame I2VYesNot primary purpose
First + last frameYesNot required
Character referenceNo dedicated reference modeYes
Multiple reference imagesNo dedicated reference modeYes
Video referenceNoYes
Motion referenceNoYes
Camera referenceNoYes
Voice/audio referenceNoYes
Native generated audioYesYes

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-H3

This 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-H3

Do 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 result

MiniMax H3 Model Specifications

MiniMax H3 model specifications
SpecificationMiniMax H3
DeveloperMiniMax
Open-weight modelH3-Base
H3-Base checkpoint familiesFL2VA and Ref2VA
Output duration4–15 seconds
Default short edge768 pixels
Frame rate24 FPS
Audio output32 kHz stereo
Full system maximum resolutionUp to 2K
2K mechanismH3-Regenerate-2K
LicenseMiniMax 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

MiniMax H3 reference input limits
InputLimit
Reference images≤ 9
Reference videos≤ 3
Each video2–15 seconds
Total reference video duration≤ 15 seconds
Reference audio clips≤ 3
Each audio clip2–15 seconds
Total reference audio duration≤ 15 seconds
Maximum mixed reference files12

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.