MiniMax CLI — Agent Skill Guide

Use mmx to generate text, images, video, speech, music, and perform web search via the MiniMax AI platform.

When to Use

Use this skill when the user wants to generate or inspect text, images, video, speech, music, web-search results, or MiniMax API resources through the mmx terminal CLI.

Prerequisites

# Install
npm install -g mmx-cli

# Auth (OAuth persists to ~/.mmx/credentials.json, API key persists to ~/.mmx/config.json)
mmx auth login --api-key sk-xxxxx

# Verify active auth source
mmx auth status

# Or pass per-call
mmx text chat --api-key sk-xxxxx --message "Hello"

Region is auto-detected. Override with --region global or --region cn.

Agent Flags

Always use these flags in non-interactive (agent/CI) contexts:

Commands

text chat

Chat completion. Default model: MiniMax-M3. Pass --model MiniMax-M2.7 for the previous-generation default when reproducing older outputs.

mmx text chat --message <text> [flags]

# Single message (uses MiniMax-M3 by default)
mmx text chat --message "user:What is MiniMax?" --output json --quiet

# Multi-turn with system prompt
mmx text chat \
  --system "You are a coding assistant." \
  --message "user:Write fizzbuzz in Python" \
  --output json

# Pin to the previous-generation model
mmx text chat --model MiniMax-M2.7 --message "user:Hello" --output json

# From file
cat conversation.json | mmx text chat --messages-file - --output json

image generate

Generate images through MiniMax. Use this command for text-to-image tasks, thumbnails, concept art, social visuals, and quick prompt iteration. Model: image-01.

mmx image generate --prompt <text> [flags]

# Machine-readable response for agents
mmx image generate --prompt "A cat in a spacesuit" --output json --quiet

# Save multiple generated images to a directory
mmx image generate --prompt "Logo" --n 3 --out-dir ./gen/ --quiet

# Select region explicitly when a workflow must stay on one MiniMax endpoint family
mmx image generate --prompt "Product hero image" --region global --output json --quiet
mmx image generate --prompt "Product hero image" --region cn --output json --quiet

Agent notes:

• Prefer --output json --quiet --non-interactive when another tool will parse the result.
• Use --dry-run before API-backed calls when validating arguments or CI examples.
• Keep generated media in a task-local output directory and validate returned file paths or URLs before reusing them.

video generate

Generate video. The current v2 default is MiniMax-H3 (2K, 4–15 seconds); the legacy v1 Hailuo models remain available when explicitly selected. Requests use the regional v2 endpoint: https://api.minimax.io/v2/video_generation (global) or https://api.minimaxi.com/v2/video_generation (China).

mmx video generate --prompt <text> [flags]

For MiniMax-H3, the request content is an ordered array of {type, role, ...} items. Text content is required (up to 7,000 characters); image, video, and audio URLs may use first_frame, last_frame, reference_image, reference_video, and reference_audio roles. Frame roles and reference roles are mutually exclusive, and reference audio requires an image or video. Set --resolution 2K, --duration to an integer from 4 through 15, and --ratio to adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, or 9:16. China requests may also set aigc_watermark. The create response returns task_id; query with GET /v2/query/video_generation/{task_id}, list with GET /v2/query/video_generation, and delete with DELETE /v2/video_generation/{task_id}. Query responses expose status, error, output URL, resolution, duration, ratio, task type/modality, and usage seconds/image count. Pricing for MiniMax-H3 video is metered by 2K output seconds: global USD 0.13/second, China CNY 0.8/second. Reference video input is global USD 0.02/second and China CNY 0.8/second; reference audio is free; five reference images are free, then global USD 0.03/image or China CNY 0.2/image.

…