/minimax-multimodal-toolkit

name: minimax-multimodal-toolkit
description: >
  MiniMax multimodal model skill — use MiniMax Multi-Modal models for speech, music, video, and image.
  Create voice, music, video, and images with MiniMax AI: TTS (text-to-speech, voice cloning, voice design,
  multi-segment), music (songs, instrumentals), video (text-to-video, image-to-video, start-end frame,
  subject reference, templates, long-form multi-scene), image (text-to-image, image-to-image with character
  reference), and media processing (convert, concat, trim, extract).
  Use when the user mentions MiniMax, multimodal generation, or wants speech/music/video/image AI,
  MiniMax APIs, or FFmpeg workflows alongside MiniMax outputs.
license: MIT
metadata:
  version: "1.0"
  category: media-generation

MiniMax Multi-Modal Toolkit

Generate voice, music, video, and image content via MiniMax APIs — the unified entry for **MiniMax multimodal** use cases (audio + music + video + image). Includes voice cloning & voice design for custom voices, image generation with character reference, and FFmpeg-based media tools for audio/video format conversion, concatenation, trimming, and extraction.

Output Directory

**All generated files MUST be saved to `minimax-output/` under the AGENT'S current working directory (NOT the skill directory).** Every script call MUST include an explicit `--output` / `-o` argument pointing to this location. Never omit the output argument or rely on script defaults.

**Rules:** 1. Before running any script, ensure `minimax-output/` exists in the agent's working directory (create if needed: `mkdir -p minimax-output`) 2. Always use absolute or relative paths from the agent's working directory: `--output minimax-output/video.mp4` 3. **Never** `cd` into the skill directory to run scripts — run from the agent's working directory using the full script path 4. Intermediate/temp files (segment audio, video segments, extracted frames) are automatically placed in `minimax-output/tmp/`. They can be cleaned up when no longer needed: `rm -rf minimax-output/tmp`

Prerequisites

brew install ffmpeg jq              # macOS (or apt install ffmpeg jq on Linux)
bash scripts/check_environment.sh

No Python or pip required — all scripts are pure bash using `curl`, `ffmpeg`, `jq`, and `xxd`.

API Host Configuration

MiniMax provides two service endpoints for different regions. Set `MINIMAX_API_HOST` before running any script:

| Region | Platform URL | API Host Value | |--------|-------------|----------------| | China Mainland（中国大陆） | https://platform.minimaxi.com | `https://api.minimaxi.com` | | Global（全球） | https://platform.minimax.io | `https://api.minimax.io` |

# China Mainland
export MINIMAX_API_HOST="https://api.minimaxi.com"

# or Global
export MINIMAX_API_HOST="https://api.minimax.io"

**IMPORTANT — When API Host is missing:** Before running any script, check if `MINIMAX_API_HOST` is set in the environment. If it is NOT configured: 1. Ask the user which service endpoint their MiniMax account uses:

• **China Mainland** → `https://api.minimaxi.com`
• **Global** → `https://api.minimax.io`

2. Instruct and help user to set it via `export MINIMAX_API_HOST="https://api.minimaxi.com"` (or the global variant) in their terminal or add it to their shell profile (`~/.zshrc` / `~/.bashrc`) for persistence

API Key Configuration

Set the `MINIMAX_API_KEY` environment variable before running any script:

export MINIMAX_API_KEY="your-api-key-here"

The key starts with `sk-api-` or `sk-cp-`, obtainable from https://platform.minimaxi.com (China) or https://platform.minimax.io (Global)

**IMPORTANT — When API Key is missing:** Before running any script, check if `MINIMAX_API_KEY` is set in the environment. If it is NOT configured: 1. Ask the user to provide their MiniMax API key 2. Instruct and help user to set it via `export MINIMAX_API_KEY="sk-..."` in their terminal or add it to their shell profile (`~/.zshrc` / `~/.bashrc`) for persistence

Plan Limits & Quotas

**IMPORTANT — Always respect the user's plan limits before generating content.** If the user's quota is exhausted or insufficient, warn them before proceeding.

Standard Plans

| Capability | Starter | Plus | Max | |---|---|---|---| | M2.7 (chat) | 600 req/5h | 1,500 req/5h | 4,500 req/5h | | Speech 2.8 | — | 4,000 chars/day | 11,000 chars/day | | image-01 | — | 50 images/day | 120 images/day | | Hailuo-2.3-Fast 768P 6s | — | — | 2 videos/day | | Hailuo-2.3 768P 6s | — | — | 2 videos/day | | Music-2.5 | — | — | 4 songs/day (≤5 min each) |

High-Speed Plans

| Capability | Plus-HS | Max-HS | Ultra-HS | |---|---|---|---| | M2.7-highspeed (chat) | 1,500 req/5h | 4,500 req/5h | 30,000 req/5h | | Speech 2.8 | 9,000 chars/day | 19,000 chars/day | 50,000 chars/day | | image-01 | 100 images/day | 200 images/day | 800 images/day | | Hailuo-2.3-Fast 768P 6s | — | 3 videos/day | 5 videos/day | | Hailuo-2.3 768P 6s | — | 3 videos/day | 5 videos/day | | Music-2.5 | — | 7 songs/day (≤5 min each) | 15 songs/day (≤5 min each) |

**Key quota constraints:**

• **Video resolution: 768P only** — 1080P is not available on any plan
• **Video duration: 6s** — all plan quotas are counted in 6-second units
• **Video quota is very limited** (2–5/day depending on plan) — always confirm with the user before generating video

Key Capabilities

| Capability | Description | Entry point | |------------|-------------|-------------| | TTS | Text-to-speech synthesis with multiple voices and emotions | `scripts/tts/generate_voice.sh` | | Voice Cloning | Clone a voice from an audio sample (10s–5min) | `scripts/tts/generate_voice.sh clone` | | Voice Design | Create a custom voice from a text description | `scripts/tts/generate_voice.sh design` | | Music Generation | Generate songs with lyrics or instrumental tracks | `scripts/music/generate_music.sh` | | Image Generation | Text-to-image, image-to-image with character reference | `scripts/imag