OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add minimax-ai/cli --skill mmx-cli
Use mmx to generate text, images, video, and speech via the MiniMax AI platform. Use when the user wants to create media content, chat with MiniMax models, perform web search, or manage MiniMax API resources from the terminal.
npx skills add minimax-ai/cli --skill mmx-cli
Use mmx to generate text, images, video, speech, and perform web search via the MiniMax AI platform.
Region is auto-detected. Override with --region global or --region cn.
Always use these flags in non-interactive (agent/CI) contexts:
| Flag | Purpose |
|---|---|
--non-interactive | Fail fast on missing args instead of prompting |
--quiet | Suppress spinners/progress; stdout is pure data |
--output json | Machine-readable JSON output |
--async | Return task ID immediately (video generation) |
--dry-run | Preview the API request without executing |
--yes | Skip confirmation prompts |
Chat completion. Default model: MiniMax-M3.
| Flag | Type | Description |
|---|---|---|
--message <text> | string, required, repeatable | Message text. Prefix with role: to set role (e.g. "system:You are helpful", "user:Hello") |
--messages-file <path> | string | JSON file with messages array. Use - for stdin |
--system <text> | string | System prompt |
--model <model> | string | Model ID (default: MiniMax-M3) |
--max-tokens <n> | number | Max tokens (default: 4096) |
--temperature <n> | number | Sampling temperature (0.0, 1.0] |
--top-p <n> | number | Nucleus sampling threshold |
--stream | boolean | Stream tokens (default: on in TTY) |
--tool <json-or-path> | string, repeatable | Tool definition JSON or file path |
stdout: response text (text mode) or full response object (json mode).
Generate images. Model: image-01.
| Flag | Type | Description |
|---|---|---|
--prompt <text> | string, required | Image description |
--aspect-ratio <ratio> | string | e.g. 16:9, 1:1. Ignored if --width and --height are both set |
--n <count> | number | Number of images (default: 1) |
--seed <n> | number | Random seed for reproducible generation |
--width <px> | number | Width in pixels (512–2048, multiple of 8). Requires --height |
--height <px> | number | Height in pixels (512–2048, multiple of 8). Requires --width |
--prompt-optimizer | boolean | Optimize prompt before generation |
--aigc-watermark | boolean | Embed AI-generated content watermark |
--subject-ref <params> | string | Subject reference: type=character,image=path-or-url |
--response-format <format> | string | url (default) or base64. Base64 bypasses CDN download |
--out-dir <dir> | string | Download images to directory |
--out-prefix <prefix> | string | Filename prefix (default: image) |
Generate video. Default model: MiniMax-Hailuo-2.3 (or MiniMax-Hailuo-2.3-Fast for fast mode with --image). This is an async task — by default it polls until completion.
For MiniMax-H3 — text-to-video, first/last-frame, multimodal reference image/video/audio generation, prompt construction, and failure handling — use the dedicated mmx-h3-video skill instead.
| Flag | Type | Description |
|---|---|---|
--prompt <text> | string, required | Video description |
--model <model> | string | MiniMax-Hailuo-2.3 (default) or MiniMax-Hailuo-2.3-Fast |
--image <path-or-url> | string | Input image for image-to-video |
--last-frame <path-or-url> | string | Optional ending image for frame interpolation (used with --image) |
--callback-url <url> | string | Webhook URL for completion |
--download <path> | string | Save video to specific file |
--async | boolean | Return task ID immediately |
--no-wait | boolean | Same as --async |
--poll-interval <seconds> | number | Polling interval (default: 5) |
Query status of a video generation task.
Download a completed video by task ID.
Text-to-speech. Default model: speech-2.8-hd. Max 10k chars.
| Flag | Type | Description |
|---|---|---|
--text <text> | string | Text to synthesize |
--text-file <path> | string | Read text from file. Use - for stdin |
--model <model> | string | speech-2.8-hd (default), speech-2.6, speech-02 |
--voice <id> | string | Voice ID (default: English_expressive_narrator) |
--speed <n> | number | Speed multiplier |
--volume <n> | number | Volume level |
--pitch <n> | number | Pitch adjustment |
--format <fmt> | string | Audio format (default: mp3) |
--sample-rate <hz> | number | Sample rate (default: 32000) |
--bitrate <bps> | number | Bitrate (default: 128000) |
--channels <n> | number | Audio channels (default: 1) |
--language <code> | string | Language boost |
--subtitles | boolean | Download and save subtitles as .srt file (alongside --out audio file). API must support subtitles for the selected model. |
--pronunciation <from/to> | string, repeatable | Custom pronunciation |
--sound-effect <effect> | string | Add sound effect |
--out <path> | string | Save audio to file |
--stream | boolean | Stream raw audio to stdout |
Image understanding via VLM. Provide either --image or --file-id, not both.
| Flag | Type | Description |
|---|---|---|
--image <path-or-url> | string | Local path or URL (auto base64-encoded) |
--file-id <id> | string | Pre-uploaded file ID (skips base64) |
--prompt <text> | string | Question about the image (default: "Describe the image.") |
stdout: description text (text mode) or full response (json mode).
Web search via MiniMax.
| Flag | Type | Description |
|---|---|---|
--q <query> | string, required | Search query |
Display Token Plan usage and remaining quotas.
Export all commands as Anthropic/OpenAI-compatible JSON tool schemas:
Use this to dynamically register mmx commands as tools in your agent framework.
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | General error |
| 2 | Usage error (bad flags, missing args) |
| 3 | Authentication error |
| 4 | Quota exceeded |
| 5 | Timeout |
| 10 | Content filter triggered |
CLI flags → environment variables → ~/.mmx/config.json → defaults.
Set per-modality defaults so you don't need --model every time:
Resolution priority: --model flag > config default > hardcoded fallback.