> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# MiniMax H3: ComfyUI Workflow Examples

> Learn how to use the open-weights MiniMax H3 in ComfyUI with native workflows for text-to-video, image-to-video, and reference-to-video, all with native stereo audio.

[MiniMax H3](https://www.minimax.io/blog/minimax-h3) is MiniMax's general-purpose, omni-modal generation model, now available as open weights. It jointly understands text, images, video, and audio in a single context, and generates video with **native stereo audio**: voice, sound effects, and music are modeled together in a single forward pass instead of being layered on afterward. Output is up to 2K resolution, 24fps, and about 15 seconds.

ComfyUI natively supports MiniMax H3. The template library currently ships with three example workflows, each covering one generation mode:

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

These three are example templates, not an exhaustive list. The model supports more generation modes through the native MiniMax H3 nodes: first/last-frame image-to-video (fl2va) via the `MiniMaxH3ImageToVideo` node, and reference-driven generation with images, videos, and audio (ref2va) via the `MiniMaxH3ReferenceToVideo` node. You can build additional workflows with these nodes.

<UpdateReminder />

## 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:

1. Update ComfyUI to version 0.30.0 or later
2. Go to **Template Library** > **Video** > choose any MiniMax H3 workflow
3. Follow the pop-up to download models and run the workflow

The model files are hosted on Hugging Face in the [Comfy-Org/MiniMax-H3](https://huggingface.co/Comfy-Org/MiniMax-H3) repository.

## Setting the output resolution

Each workflow uses a **Resolution Selector** node to control the overall output size. The node computes `width` 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)`, or `1: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 `32` to match H3's resolution grid

The template ships with a fast preview size. For full-quality output, raise Megapixels to about `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.

<video controls className="w-full aspect-video" src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/video_minimax_h3_t2v.mp4" />

<CardGroup cols={2}>
  <Card title="Run in Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=video_minimax_h3_t2v&utm_source=docs&utm_medium=referral&utm_campaign=minimax-h3">
    Open in Comfy Cloud
  </Card>

  <Card title="Download Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_minimax_h3_t2v.json">
    Download JSON or search "MiniMax H3 T2V" in Template Library
  </Card>
</CardGroup>

#### Model downloads

<CardGroup cols={2}>
  <Card title="Diffusion Model: minimax_h3_fl2va_pruned_int8_convrot" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/diffusion_models/minimax_h3_fl2va_pruned_int8_convrot.safetensors">
    Place in <code>ComfyUI/models/diffusion\_models/</code>
  </Card>

  <Card title="Text Encoder: qwen3vl_32b_minimax_h3_int8_convrot" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/text_encoders/qwen3vl_32b_minimax_h3_int8_convrot.safetensors">
    Place in <code>ComfyUI/models/text\_encoders/</code>
  </Card>

  <Card title="VAE: minimax_h3_video_vae_fp16" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/vae/minimax_h3_video_vae_fp16.safetensors">
    Place in <code>ComfyUI/models/vae/</code>
  </Card>

  <Card title="VAE: minimax_h3_audio_vae_fp32" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/vae/minimax_h3_audio_vae_fp32.safetensors">
    Place in <code>ComfyUI/models/vae/</code>
  </Card>
</CardGroup>

#### Model storage

```
ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   └── minimax_h3_fl2va_pruned_int8_convrot.safetensors
│   ├── 📂 text_encoders/
│   │   └── qwen3vl_32b_minimax_h3_int8_convrot.safetensors
│   └── 📂 vae/
│       ├── minimax_h3_video_vae_fp16.safetensors
│       └── minimax_h3_audio_vae_fp32.safetensors
```

#### Prompting tips

1. **Describe the whole scene**: State the overall scene first (location, character, what is happening), then break it into timed shots
2. **Shots, camera, and audio**: Describe the shots, camera moves, and the accompanying audio (dialogue, SFX, music) in one prompt block
3. **Resolution**: H3's native canvas is a 768px short edge, capped at 768x1344 pixels and rounded to a multiple of 32
4. **Duration**: The duration input snaps to the model's 17-frame-per-block (17k+5) grid at 24fps
5. **First/last frame**: Connect images to `first_frame` and/or `last_frame` on the `MiniMaxH3ImageToVideo` node to turn this workflow into first/last-frame image-to-video

***

### MiniMax H3 Image to Video (I2V)

Generate videos from an input image, with optional first/last-frame keyframes.

<video controls className="w-full aspect-video" src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/video_minimax_h3_i2v.mp4" />

<CardGroup cols={2}>
  <Card title="Run in Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=video_minimax_h3_i2v&utm_source=docs&utm_medium=referral&utm_campaign=minimax-h3">
    Open in Comfy Cloud
  </Card>

  <Card title="Download Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_minimax_h3_i2v.json">
    Download JSON or search "MiniMax H3 I2V" in Template Library
  </Card>
</CardGroup>

<CardGroup cols={1}>
  <Card title="Input Image: transparent_rgb_gaming_mouse.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/transparent_rgb_gaming_mouse.png">
    Download the default input image, or use your own image.
  </Card>
</CardGroup>

#### Model downloads

<CardGroup cols={2}>
  <Card title="Diffusion Model: minimax_h3_fl2va_pruned_int8_convrot" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/diffusion_models/minimax_h3_fl2va_pruned_int8_convrot.safetensors">
    Place in <code>ComfyUI/models/diffusion\_models/</code>
  </Card>

  <Card title="Text Encoder: qwen3vl_32b_minimax_h3_int8_convrot" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/text_encoders/qwen3vl_32b_minimax_h3_int8_convrot.safetensors">
    Place in <code>ComfyUI/models/text\_encoders/</code>
  </Card>

  <Card title="VAE: minimax_h3_video_vae_fp16" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/vae/minimax_h3_video_vae_fp16.safetensors">
    Place in <code>ComfyUI/models/vae/</code>
  </Card>

  <Card title="VAE: minimax_h3_audio_vae_fp32" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/vae/minimax_h3_audio_vae_fp32.safetensors">
    Place in <code>ComfyUI/models/vae/</code>
  </Card>
</CardGroup>

#### Model storage

```
ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   └── minimax_h3_fl2va_pruned_int8_convrot.safetensors
│   ├── 📂 text_encoders/
│   │   └── qwen3vl_32b_minimax_h3_int8_convrot.safetensors
│   └── 📂 vae/
│       ├── minimax_h3_video_vae_fp16.safetensors
│       └── minimax_h3_audio_vae_fp32.safetensors
```

#### Prompting tips

1. **Keyframes**: The `first_frame` and `last_frame` inputs are optional; the model generates the motion between them
2. **Prompt**: Describe the shots, motion, and the accompanying audio (dialogue, SFX, music) in one block
3. **Resolution**: H3's native canvas is a 768px short edge, capped at 768x1344 pixels and rounded to a multiple of 32
4. **Duration**: The duration input snaps to the model's 17-frame-per-block (17k+5) grid at 24fps

***

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

<video controls className="w-full aspect-video" src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/video_minimax_h3_r2v.mp4" />

<CardGroup cols={2}>
  <Card title="Run in Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=video_minimax_h3_r2v&utm_source=docs&utm_medium=referral&utm_campaign=minimax-h3">
    Open in Comfy Cloud
  </Card>

  <Card title="Download Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_minimax_h3_r2v.json">
    Download JSON or search "MiniMax H3 R2V" in Template Library
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Reference Image: red_superboy_on_city_roof.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/red_superboy_on_city_roof.png">
    Character reference for the workflow, or use your own images.
  </Card>

  <Card title="Reference Image: mecha_dragon_lightning.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/mecha_dragon_lightning.png">
    Style and subject reference for the workflow, or use your own images.
  </Card>
</CardGroup>

#### Model downloads

<CardGroup cols={2}>
  <Card title="Diffusion Model: minimax_h3_ref2va_pruned_int8_convrot" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/diffusion_models/minimax_h3_ref2va_pruned_int8_convrot.safetensors">
    Place in <code>ComfyUI/models/diffusion\_models/</code>
  </Card>

  <Card title="Text Encoder: qwen3vl_32b_minimax_h3_int8_convrot" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/text_encoders/qwen3vl_32b_minimax_h3_int8_convrot.safetensors">
    Place in <code>ComfyUI/models/text\_encoders/</code>
  </Card>

  <Card title="VAE: minimax_h3_video_vae_fp16" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/vae/minimax_h3_video_vae_fp16.safetensors">
    Place in <code>ComfyUI/models/vae/</code>
  </Card>

  <Card title="VAE: minimax_h3_audio_vae_fp32" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/vae/minimax_h3_audio_vae_fp32.safetensors">
    Place in <code>ComfyUI/models/vae/</code>
  </Card>
</CardGroup>

#### Model storage

```
ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   └── minimax_h3_ref2va_pruned_int8_convrot.safetensors
│   ├── 📂 text_encoders/
│   │   └── qwen3vl_32b_minimax_h3_int8_convrot.safetensors
│   └── 📂 vae/
│       ├── minimax_h3_video_vae_fp16.safetensors
│       └── minimax_h3_audio_vae_fp32.safetensors
```

#### Prompting tips

1. **Reference by tag**: Reference each input by tag in the exact order it was connected, for example `<Picture 1>`, `<Video 1>`, `<Audio 1>`
2. **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
3. **Limits**: Up to 9 reference images, 3 reference videos (each can carry its own soundtrack), and 3 standalone reference audio clips
4. **ref\_image\_size**: `match` scales references down to the generation resolution for speed; `max` keeps up to a 2048px short edge for stronger identity fidelity at the cost of speed
5. **Sampler**: `res_multistep` with a `beta` or `normal` scheduler tends to outperform `simple` for reference-heavy prompts
6. **Note**: R2V uses the `ref2va` diffusion model, a different set of weights from the `fl2va` model used by the T2V and I2V workflows
