---
name: minimax-video
description: >
  Generate a short video clip from a text prompt or an image via the MiniMax
  video API. Use when the user wants video, a moving clip, animation, or a
  short film. Trigger on phrases like "make a video", "animate this", "film",
  "create a clip", "video of X".
allowed-tools: Bash(minimax-gen video *), Bash(minimax-gen --help), Bash(mkdir *), Bash(ls *), Bash(test *), Bash(file *), Read
---

# /minimax-video — Video Generation

Generate a short video clip. Asynchronous — submit, poll, download.

## CLI

```bash
# Text-to-video
minimax-gen video --prompt "A paper plane gliding over a city" \
  --duration 6 --resolution 768P \
  --out /tmp/plane.mp4

# Image-to-video (animate a still)
minimax-gen video --image-url https://example.com/cover.jpg \
  --out /tmp/anim.mp4
```

The CLI is at `~/dev/claude/gamedev/minimax-gen/bin/minimax-gen`.

## Models and resolutions

| Model | Resolutions |
|---|---|
| `MiniMax-Hailuo-2.3` (default) | `768P`, `1080P` |
| `MiniMax-Hailuo-2.3Fast` | `768P`, `1080P` (cheaper, faster) |
| `MiniMax-Hailuo-02` | legacy |

`720p` is rejected — use `768P` or `1080P` (capitalised).

## Duration

Common: 6 seconds. The default is 6.

## Timeouts

Async work — total wall-clock can be 1–5 minutes. Default `--timeout` is 900s.
`--poll-interval` controls how often we ask the server for status (default 5s).

## After the call

1. Show the path written and the `task_id` from the sidecar `.meta.json`.
2. Note the resolution (`video_width` × `video_height`) and file size.
3. Do NOT print the meta JSON — point at the file.

## Never do

- Never echo, log, or commit the contents of `~/.claude-secrets/minimax-auth-token`.

## Reference

Full option list: `minimax-gen video --help`