# Mmx CLI

> Generate text, images, video, speech, and music via the MiniMax AI platform. Covers text generation (MiniMax-M3 model), image generation (image-01), video generation (Hailuo-2.3), speech synthesis (speech-2.8-hd, 300+ voices), music generation (music-2.6 with lyrics, cover, and instrumental), and web search. Use when the user needs to create AI-generated multimedia content, produce narrated audio from text, compose music, or search the web through MiniMax AI services.

- Skill: `agentscope-ai/mmx-cli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentscope-ai/mmx-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentscope-ai/mmx-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: agentscope-ai (https://skillmd.com/u/agentscope-ai)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/agentscope-ai/mmx-cli

---


# mmx-cli Skill

Generate multimedia content (text, images, video, speech, music) via the
[MiniMax AI](https://github.com/MiniMax-AI/cli) platform.

## Install

```bash
npx skills add MiniMax-AI/cli@skill -g -y
```

Or manually:

```bash
npm install -g @minimax-ai/cli
```

Set your API key:

```bash
export MINIMAX_API_KEY=your_api_key_here
```

## Capabilities

| Capability | Command | Model |
|------------|---------|-------|
| Text generation | `mmx text generate` | MiniMax-M3 |
| Image generation | `mmx image generate` | image-01 |
| Video generation | `mmx video generate` | Hailuo-2.3 |
| Speech synthesis | `mmx speech generate` | speech-2.8-hd |
| Music generation | `mmx music generate` | music-2.6 |
| Web search | `mmx search` | — |

## Quick Examples

```bash
# Generate text
mmx text generate "Summarize the key benefits of reinforcement learning"

# Generate an image
mmx image generate "A futuristic city skyline at sunset, photorealistic"

# Generate a short video clip
mmx video generate "A golden retriever playing in autumn leaves"

# Synthesize speech from text
mmx speech generate --text "Hello, welcome to the demo." --voice Calm_Woman

# Generate music with lyrics
mmx music generate --lyrics "Rise and shine, a brand new day" --style "pop upbeat"

# Web search
mmx search "latest advances in LLM evaluation"
```

## Gather from user before running

| Info | Required? | Notes |
|------|-----------|-------|
| MINIMAX_API_KEY | Yes | From [MiniMax platform](https://www.minimaxi.com/) |
| Prompt or text | Yes | Describe what to generate |
| Voice name | No | For speech; run `mmx speech list-voices` to browse 300+ options |
| Output path | No | Default saves to current directory |

## Tips

- Use `--output json` flag for structured output suitable for pipelines.
- Use `--non-interactive` and `--quiet` flags in automated / agent workflows.
- Run `mmx --help` or `mmx <subcommand> --help` to see all options.
- The [SKILL.md](https://github.com/MiniMax-AI/cli/blob/main/skill/SKILL.md)
  in the upstream repo is always up-to-date with the latest flags and models.