How do I install the Minimax Token Plan skill?

Run npx skillmds@latest add minimax-ai/minimax-token-plan in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Minimax Token Plan safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Minimax Token Plan?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Minimax Token Plan free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Minimax Token Plan?

MiniMax AI (@minimax-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Minimax Token Plan by minimax-ai — Agent Skill

Name: Minimax Token Plan
Author: MiniMax AI

Minimax Token Plan

Use MiniMax Token Plan and optional pay-as-you-go multimodal tools for web search, image understanding and generation, speech, video, lyrics, music, and music covers while preserving entitlement and cost boundaries.

MiniMax AI Updated Sep 17, 2026 12.9k repo stars

File contents

MiniMax Token Plan workflows

Use this skill when the user asks to use MiniMax Token Plan, MiniMax image or speech generation, Hailuo/H3 video, MiniMax Music, lyrics generation, or the MiniMax multimodal API.

Mandatory routing

Call minimax_get_capabilities before the first external MiniMax call in a task.
Explain which configured key class and quota/balance route the requested tool will use.
Obtain explicit user confirmation before setting confirm_usage: true.
Use Token Plan tools for search, image understanding, eligible image generation, and eligible speech. H3 video and voice design/cloning require another billing route. Music/lyrics may use a Token Plan key only for an existing eligible account; never claim new-user availability.
For video, create a task and return its task ID. Query status separately; do not busy-poll.
Treat music and lyrics as grandfathered capabilities. Since 2026-08-20, new users cannot obtain paid API access. If the API rejects access, report the boundary and suggest MiniMax Audio or the open-source MiniMax Music 3 model rather than retrying.

Media rules

Vision and single subject-reference inputs accept HTTPS URLs or bounded data:image/jpeg|png|webp;base64,... values; never pass arbitrary local paths.
Video reference-image, video, and audio collections require HTTPS URLs. First/last-frame inline data images are deliberately smaller so the complete JSON-RPC request stays within the stdio safety limit.
Prefer URL output to keep large binary payloads out of MCP context.
Generated URLs can expire; tell the user to persist desired outputs promptly.
Never echo API keys, authorization headers, or full data-URI media.
Do not describe a successful request as free. Token Plan calls consume quota; paygo calls may consume Credits or account balance.

Failure handling

Authentication errors: verify that key region matches MINIMAX_API_HOST.
Status 2056 or usage-limit messages: report the quota/model mismatch and suggest an eligible model or waiting for reset; do not silently swap key classes.
HTTP 429: preserve the trace ID and ask the user to retry later.
Music/lyrics access rejection: report the 2026-08-20 new-user cutoff.
Never retry generation automatically after an uncertain response because the original request may already have consumed quota or created a task.

---name: minimax-token-plandescription: Use MiniMax Token Plan and optional pay-as-you-go multimodal tools for web search, image understanding and generation, speech, video, lyrics, music, and music covers while preserving entitlement and cost boundaries.---# MiniMax Token Plan workflowsUse this skill when the user asks to use MiniMax Token Plan, MiniMax image or speech generation,Hailuo/H3 video, MiniMax Music, lyrics generation, or the MiniMax multimodal API.## Mandatory routing1. Call `minimax_get_capabilities` before the first external MiniMax call in a task.2. Explain which configured key class and quota/balance route the requested tool will use.3. Obtain explicit user confirmation before setting `confirm_usage: true`.4. Use Token Plan tools for search, image understanding, eligible image generation, and eligible speech. H3 video and voice design/cloning require another billing route. Music/lyrics may use a Token Plan key only for an existing eligible account; never claim new-user availability.5. For video, create a task and return its task ID. Query status separately; do not busy-poll.6. Treat music and lyrics as grandfathered capabilities. Since 2026-08-20, new users cannot obtain paid API access. If the API rejects access, report the boundary and suggest MiniMax Audio or the open-source MiniMax Music 3 model rather than retrying.## Media rules- Vision and single subject-reference inputs accept HTTPS URLs or bounded `data:image/jpeg|png|webp;base64,...` values; never pass arbitrary local paths.- Video reference-image, video, and audio collections require HTTPS URLs. First/last-frame inline data images are deliberately smaller so the complete JSON-RPC request stays within the stdio safety limit.- Prefer URL output to keep large binary payloads out of MCP context.- Generated URLs can expire; tell the user to persist desired outputs promptly.- Never echo API keys, authorization headers, or full data-URI media.- Do not describe a successful request as free. Token Plan calls consume quota; paygo calls may consume Credits or account balance.## Failure handling- Authentication errors: verify that key region matches `MINIMAX_API_HOST`.- Status `2056` or usage-limit messages: report the quota/model mismatch and suggest an eligible model or waiting for reset; do not silently swap key classes.- HTTP 429: preserve the trace ID and ask the user to retry later.- Music/lyrics access rejection: report the 2026-08-20 new-user cutoff.- Never retry generation automatically after an uncertain response because the original request may already have consumed quota or created a task.

Frequently asked questions