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

# ComfyUI MiniMax H3 Text-to-Video, Image-to-Video, and Reference-to-Video Workflows

> Run MiniMax H3 text-to-video (T2V), image-to-video (I2V), and reference-to-video (R2V) workflows in ComfyUI, plus advanced native-node techniques for guide anchoring and latent noise masks.

This page covers the three base MiniMax H3 template workflows in ComfyUI, plus advanced techniques built on the native H3 nodes. For model capabilities, prompt writing, and speedups, see the [MiniMax H3 overview](/tutorials/video/minimax/minimax-h3).

## 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 on 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_nvfp4_awq" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.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>

  <Card title="LoRA: minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16" icon="download" href="https://huggingface.co/lightx2v/Minimax-h3-Turbo/resolve/main/minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors">
    Required by the workflow's model scan; powers the optional Lightning LoRA turbo mode. Place in <code>ComfyUI/models/loras/</code>
  </Card>
</CardGroup>

### Model storage

```
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
│   ├── 📂 loras/
│   │   └── minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors
│   └── 📂 embeddings/
│       └── minimaxh3_art_is_explosion.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, which is 1344x768 at 16:9, and resolutions are 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
6. **Turbo mode (optional)**: The workflow generates at 20 steps by default; raise the step count (for example to 25) for better motion quality. Enable `turbo_mode` on the MiniMax H3 node to use the included Lightning LoRA (`minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16`) at 8 steps for much faster generation, with slightly lower audio and motion quality

The official base-mode [prompt writing guide](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_base_en.md) is summarized in the [prompt guide](/tutorials/video/minimax/minimax-h3-prompt-guide).

## 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 on 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_nvfp4_awq" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.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>

<CardGroup cols={1}>
  <Card title="Turbo LoRA: minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16" icon="download" href="https://huggingface.co/lightx2v/Minimax-h3-Turbo/blob/main/minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors">
    Place in <code>ComfyUI/models/loras/</code>. Used when <code>turbo\_mode</code> is enabled.
  </Card>
</CardGroup>

### Model storage

```
ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   └── minimax_h3_fl2va_pruned_int8_convrot.safetensors
│   ├── 📂 text_encoders/
│   │   └── qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors
│   ├── 📂 loras/
│   │   └── minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors
│   ├── 📂 vae/
│   │   ├── minimax_h3_video_vae_fp16.safetensors
│   │   └── minimax_h3_audio_vae_fp32.safetensors
│   └── 📂 embeddings/
│       └── minimaxh3_art_is_explosion.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, which is 1344x768 at 16:9, and resolutions are 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. **Turbo mode**: Enable `turbo_mode` on the MiniMax H3 node to switch to the turbo LoRA and generate in `turbo_steps` (default 8) instead of 20 steps. `turbo_model_strength` controls the LoRA strength (default 1.0).

The official base-mode [prompt writing guide](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_base_en.md) is summarized in the [prompt guide](/tutorials/video/minimax/minimax-h3-prompt-guide).

## 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 on 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_nvfp4_awq" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.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>

  <Card title="LoRA: minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/loras/minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors">
    Required by the workflow's model scan; powers the optional Lightning LoRA turbo mode. Place in <code>ComfyUI/models/loras/</code>
  </Card>
</CardGroup>

### Model storage

```
ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   └── minimax_h3_ref2va_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
│   ├── 📂 loras/
│   │   └── minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors
│   └── 📂 embeddings/
│       └── minimaxh3_art_is_explosion.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. **Note**: R2V uses the `ref2va` diffusion model, a different set of weights from the `fl2va` model used by the T2V and I2V workflows
6. **Turbo mode (optional)**: The workflow generates at 20 steps by default; raise the step count (for example to 25) for better motion quality. Enable the **Lightning LoRA** checkbox to use the 4-step turbo LoRA (`minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16`) for much faster generation, with slightly lower audio and motion quality

The official full-reference-mode [prompt writing guide](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_ref_en.md) is summarized in the [prompt guide](/tutorials/video/minimax/minimax-h3-prompt-guide).

## Advanced workflows with the native nodes

The native MiniMax H3 nodes support two additional workflows that landed in recent ComfyUI updates. Update ComfyUI to the latest version to use them.

### Anchoring guides at any frame (#15439)

[Comfy-Org/ComfyUI#15439](https://github.com/Comfy-Org/ComfyUI/pull/15439) added the `MiniMaxH3AddGuide` node. Before it, keyframes could only anchor at the first and last frame of the video. The node removes that restriction: a guide can anchor at any frame, on a continuous time axis.

Connect the `positive` and latent outputs of a MiniMax H3 node to `MiniMaxH3AddGuide`, then provide at least one guide input:

* **image**: A still image or a clip. Multi-frame batches are anchored as a clip and cropped down to the model's valid clip lengths: 5, 22, 39... frames (17k+5). Batches shorter than 5 frames use only the first image
* **audio**: A soundtrack anchored at the same frame index, cropped to the video's remaining duration
* **frame\_idx**: The frame to anchor at. Negative values count from the end of the video

Connect the video VAE to `vae` when you provide an image, and the audio VAE to `audio_vae` when you provide audio. Chain several `MiniMaxH3AddGuide` nodes to anchor guides at multiple frames.

For example, feed the first 22 frames of an existing video plus its audio into a `MiniMaxH3AddGuide` at frame 0, and the model generates the continuation of both streams. Or place a still image at frame 60 of a 124-frame video to force the video to pass through that frame.

First/last-frame anchoring produces the same coordinates as before, so existing workflows keep working unchanged.

The [Multiframe Reference](/tutorials/video/minimax/minimax-h3-multiframe) template is a ready-made workflow built on this node.

### Inpainting and extension with latent noise masks (#15375)

[Comfy-Org/ComfyUI#15375](https://github.com/Comfy-Org/ComfyUI/pull/15375) added per-token noise masks for MiniMax H3, covering both the video and audio latents. You can now regenerate only part of a video while keeping the rest fixed.

Connect a mask to the sampler's `denoise_mask` input as usual: a value of `0` preserves the corresponding latent region, while `1` regenerates it. Video masks snap to the model's 2x2 latent patch grid, and audio masks to whole latent frames. Use it for local inpainting, object removal, or extending a clip while keeping the existing content stable.
