# Mmx H3 Video

Generate, monitor, and download MiniMax-H3 videos through the mmx CLI.

- Repository: https://github.com/MiniMax-AI/cli (2209 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-10-19
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add MiniMax-AI/cli --skill mmx-h3-video -g -a claude-code -y`
Codex: `npx skills add MiniMax-AI/cli --skill mmx-h3-video -g -a codex -y`
Cursor: `npx skills add MiniMax-AI/cli --skill mmx-h3-video -g -a cursor -y`
Gemini CLI: `npx skills add MiniMax-AI/cli --skill mmx-h3-video -g -a gemini-cli -y`

## Description

Generate, monitor, and download MiniMax-H3 videos through the mmx CLI. Use for H3 text-to-video, first/last-frame video, multimodal reference image/video/audio generation, H3 prompt improvement, media preflight, Pay-as-you-go API key selection, task waiting, downloads, and H3 failure handling.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# MiniMax-H3 Video With MMX

Use this skill only for `MiniMax-H3` video generation. Do not handle text, image generation, speech, music, search, legacy Hailuo models, or unrelated MMX commands.

Before a paid request, read `references/h3-video.md` for prompt construction, media constraints, waiting behavior, and failure handling.

## Required Rules

1. Use a Pay-as-you-go/Credit API Key. H3 does not use OAuth or Token Plan Subscription Keys.
2. Reuse a saved MMX API key when available. Never print, repeat, or place a literal API key in a command transcript.
3. Always pass `--model MiniMax-H3`; never rely on the configured default model.
4. For a completed video, run one direct blocking `mmx video generate` command. Do not use Bash wrappers or hand-written polling loops.
5. If the terminal command remains active, wait on that exact execution session. Do not run `ps`, scrape process arguments, inspect the output repeatedly, kill the process, or submit another task.
6. Treat `Detecting region... cn` or `Detecting region... global` as normal stderr progress, not a submission failure.
7. Never submit a replacement paid task because terminal waiting, status polling, or downloading was interrupted.
8. Retry the alternate region at most once, and only when the first command clearly failed before task creation because of region detection, endpoint, or authentication routing.
9. Use `--async` only when the user explicitly wants a task ID without waiting or downloading.

## Resolve The CLI

Inside the `minimax-cli` repository, build changes and use the local artifact:

```bash
bun run build
node ./dist/mmx.mjs video generate --help
```

Outside the repository, use the installed `mmx` executable. Do not install or update MMX unless the user asks.

In commands below, replace `mmx` with `node ./dist/mmx.mjs` when testing the local repository build.

## Resolve And Save The API Key

Before the first paid H3 request, inspect the active credential without exposing it:

The rest: https://github.com/MiniMax-AI/cli/blob/HEAD/skill/h3-video/SKILL.md