name	minimax-cli
description	Multimodal MiniMax Token Plan capabilities via the official `mmx` CLI — text chat, image, video, music, speech synthesis, vision, and web search. Use this skill whenever the user wants to generate images / video / audio, transcribe, or perform web search with the same Token Plan API key already configured for MiniMax Copilot.

minimax-cli (mmx)

A single CLI that exposes the full MiniMax Token Plan surface (text, image, video, music, speech, vision, web search). Generated files land in the current directory's minimax-output/ folder.

The CLI is installed with npm install -g mmx-cli. The user's API key is configured with mmx auth login --api-key <key> and the quota can be inspected with mmx quota.

When to use this skill

Use mmx whenever the user asks for any of the following and the answer involves generating media, running web search, or transcribing audio:

"Generate an image / picture / poster of …"
"Make a video of …"
"Compose a song about …"
"Read this text aloud" / "speak this with voice X"
"What's in this image?" (use mmx vision describe)
"Search the web for …" (use mmx search query)
"How much quota do I have left?" (use mmx quota)

Prefer the dedicated subcommand over mmx text chat when the user explicitly wants a non-text modality — the subcommands carry modality-specific flags (aspect ratio, voice id, duration, etc.) that the generic chat does not.

Quick reference

Modality	Command
Text chat	`mmx text chat --prompt "..."`
Image generation	`mmx image generate --prompt "..." --aspect 16:9`
Video generation (async)	`mmx video generate --prompt "..."`
Music generation	`mmx music generate --prompt "..." [--lyrics "..."]`
Speech synthesis (TTS)	`mmx speech synthesize --text "..." --voice <id>`
Vision (image → text)	`mmx vision describe --image <path-or-url>`
Web search	`mmx search query --q "..."`
Quota / plan	`mmx quota`
Auth status	`mmx auth status`

Run mmx <subcommand> --help for the full flag list. Generated files are written to ./minimax-output/.

Operational notes

The CLI must be installed (npm install -g mmx-cli) and the user must be logged in (mmx auth login --api-key <key>) before any of the subcommands will work. If the user has not done so, walk them through the install steps and then retry the call.
mmx video generate returns a task id; use the follow-up task query / download command from --help to wait for the result.
Generated media is local — show the user the file path or open it in the editor rather than dumping base64.

If a subcommand fails with 401 Unauthorized, the key is mismatched against the configured region. Set region explicitly:

mmx config set --key region --value cn       # mainland China key
mmx config set --key region --value global   # international key

minimax-cli (mmx)

A single CLI that exposes the full MiniMax Token Plan surface (text, image, video, music, speech, vision, web search). Generated files land in the current directory's minimax-output/ folder.

The CLI is installed with npm install -g mmx-cli. The user's API key is configured with mmx auth login --api-key <key> and the quota can be inspected with mmx quota.

When to use this skill

Use mmx whenever the user asks for any of the following and the answer involves generating media, running web search, or transcribing audio:

"Generate an image / picture / poster of …"

"Make a video of …"

"Compose a song about …"

"Read this text aloud" / "speak this with voice X"

"What's in this image?" (use mmx vision describe)

"Search the web for …" (use mmx search query)

"How much quota do I have left?" (use mmx quota)

Quick reference

Modality

Command

Text chat

mmx text chat --prompt "..."

Image generation

mmx image generate --prompt "..." --aspect 16:9

Video generation (async)

mmx video generate --prompt "..."

Music generation

mmx music generate --prompt "..." [--lyrics "..."]

Speech synthesis (TTS)

mmx speech synthesize --text "..." --voice <id>

Vision (image → text)

mmx vision describe --image <path-or-url>

Web search

mmx search query --q "..."

Quota / plan

mmx quota

Auth status

mmx auth status

Run mmx <subcommand> --help for the full flag list. Generated files are written to ./minimax-output/.

Operational notes

The CLI must be installed (npm install -g mmx-cli) and the user must be logged in (mmx auth login --api-key <key>) before any of the subcommands will work. If the user has not done so, walk them through the install steps and then retry the call.

mmx video generate returns a task id; use the follow-up task query / download command from --help to wait for the result.

Generated media is local — show the user the file path or open it in the editor rather than dumping base64.

If a subcommand fails with 401 Unauthorized, the key is mismatched against the configured region. Set region explicitly:

mmx config set --key region --value cn       # mainland China key
mmx config set --key region --value global   # international key