/minimax-h3-video

name: minimax-h3-video
description: Build MiniMax H3 (Hailuo) local video workflows with native T2V/I2V/R2V nodes, Comfy-Org INT8 weights, turbo LoRAs for 8GB VRAM, 15-second stereo-audio clips, and the official MiniMax prompting guides (cite by link, do not copy).
globs:
  - "**/*.json"

MiniMax H3 (Hailuo) — local video

This skill teaches the **local-weights** MiniMax H3 path in ComfyUI. It is the pilot for `#1155` (Official vs Empirical sources) because MiniMax publishes a real prompting guide. **Cite that guide by URL. Do not copy it into this repo.**

Two products, two cost models — pick one

They share a brand and **must not be mixed**.

| Path | Nodes | Cost | VRAM | When | |---|---|---|---|---| | **Local weights** (this skill) | `MiniMaxH3ImageToVideo`, `MiniMaxH3ReferenceToVideo`, `EmptyMiniMaxH3LatentAV`, `MiniMaxH3SigmaShift`, `MiniMaxH3MemoryEfficientSageAttentionPatch` | Free after download | Yes — INT8 + turbo LoRA is the 8 GB story | User wants 4–15 s stereo clips on their GPU | | **Partner API** | `MinimaxHailuo03TextToVideoNode`, `MinimaxHailuo03FirstLastFrameNode`, `MinimaxHailuo03ReferenceNode`, `MinimaxTextToVideoNode`, `MinimaxImageToVideoNode`, `MinimaxHailuoVideoNode` | Paid per generation | None | User has a MiniMax / Hailuo API key and does not want local weights |

API nodes do not take `MiniMaxH3SigmaShift` or Sage-attention patches. Local nodes do not spend API credits. If the user asked for Hailuo *cloud*, stop and use the API nodes + their key; do not download 40 GB of weights.

`MiniMaxH3Director` is a **third-party** pack (`muse-collective-26/MiniMaxH3-Director`), not core. Do not require it for T2V / I2V / R2V.

License — cite, do not copy

Local weights and MiniMax's own documentation sit under the [MiniMax H3 Community License](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/LICENSE). `Materials` includes the Documentation. The agreement's Applicable Territory **excludes the United States, the EU, the UK, and South Korea**. This skill does **not** reproduce MiniMax's `skills/h3-prompt-writing/` SKILL.md or the prompting-guide prose. Linking to a public URL is the `#1155` requirement.

This is not legal advice. Tell a US/EU/UK/KR user that the *local* path is territory-restricted and that the **paid API** is a separate product under MiniMax platform terms.

Prefer the Comfy-Org template over hand-wiring

ComfyUI ≥ **0.30.0** (templates in the 0.33 line). These are **core** `comfyui-workflow-templates` graphs in the frontend **Template Library → Video**, not installer packs and not custom-node `example_workflows`:

| Mode | Template Library card | File | Diffusion file | |---|---|---|---| | T2V / I2V / FL2VA | MiniMax H3: Text to Video / Image to Video | `video_minimax_h3_t2v.json` / `video_minimax_h3_i2v.json` | `minimax_h3_fl2va_pruned_int8_convrot.safetensors` | | R2V (omni-reference) | MiniMax H3: Reference to Video | `video_minimax_h3_r2v.json` | `minimax_h3_ref2va_pruned_int8_convrot.safetensors` |

`list_packs action:"list_templates"` will **not** list them. `enqueue_workflow action:"run_template"` will **not** resolve `video_minimax_h3_t2v` / `_i2v` / `_r2v`. That action only loads bundled installer packs, and there is no `packs/minimax-h3-*` yet. Do not call it until a pack exists. `panel_load_workflow` needs `pack:`, a disk `path:`, or an inline UI `graph`. A Template Library basename is none of those.

**Load path that works:**

1. **Preferred.** Ask the user to open **Template Library → Video → MiniMax H3: Text to Video** (or Image to Video / Reference to Video). Pick the local `video_minimax_h3_*` cards, **not** the `api_minimax_h3_*` paid partner templates. 2. **Agent, no UI click.** Fetch the UI JSON from https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_minimax_h3_t2v.json (or `_i2v` / `_r2v`; raw.githubusercontent.com is the same files), save it with `save_workflow action:"save"` `filename:"video_minimax_h3_t2v.json"`, then `panel_load_workflow path:"video_minimax_h3_t2v.json"`. Same pattern as `video-extend` (stage on disk, then `path:`). Do not pass the GitHub URL as `path:` or `pack:`.

After it lands, retarget the **subgraph's exposed widgets** (prompt, duration, `turbo_mode`, megapixels). Official T2V/I2V graphs wrap `MiniMaxH3ImageToVideo` inside a subgraph (`type` is a UUID). Do not flatten that interior unless you are hand-building.

Hand-building the subgraph is slower and easy to get wrong.

Comfy tutorial (wiring, not MiniMax's prompt formula): https://docs.comfy.org/tutorials/video/minimax/minimax-h3

Models (Comfy-Org INT8 pack)

All from `huggingface.co/Comfy-Org/MiniMax-H3`. Download with `download_model` `action:"download"`.

| File | Folder | Role | |---|---|---| | `minimax_h3_fl2va_pruned_int8_convrot.safetensors` | `diffusion_models/` | T2V / I2V / first-last-frame | | `minimax_h3_ref2va_pruned_int8_convrot.safetensors` | `diffusion_models/` | R2V only — **different UNet** | | `qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors` | `text_encoders/` | Qwen3-VL-32B encoder, `CLIPLoader` **type=`minimax`** | | `minimax_h3_video_vae_fp16.safetensors` | `vae/` | Visual VAE | | `minimax_h3_audio_vae_fp32.safetensors` | `vae/` | Stereo audio VAE (32 kHz) |

Turbo LoRAs (4–8 steps instead of ~20)

The Comfy-Org T2V template already switches these on with `turbo_mode`:

| Steps | File | Source | |---|---|---| | 8 | `minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors` | `lightx2v/Minimax-h3-Turbo` | | 4 | `minimax_h3_fl2v_turbo_4step_v1.0_768p_comfyui_bf16.safetensors` | `Comfy-Org/MiniMax-H3` `loras/` |

Kijai conversions live at `Kijai/MiniMax-H3_comfy` (`loras/`) and experimental W4A8 at `Kijai/MiniMax-H3-experimental`. Same job (low-step / low-VRAM). Prefer the Comfy-Org / lightx2v filenames the template already names; only switch to a Kijai file if that is what is on disk.

4-step is faster and softer; **6 to 8 steps** is the usual sharpness