MiniMax Design
Plugin marketplaces
This plugin belongs to AIGC content creation.
| Category | Marketplace | Purpose |
|---|
| Full-stack development | Full Stack Plugins | Architecture and UI design, code understanding, quality checks, code review, workflow governance, and server operations |
| AIGC content creation | Full AIGC Plugins | Image, video, audio, music, 3D, and multimodal content creation |
MiniMax Design
Generate MiniMax H3 video, music, speech, and images from your coding agent: environment-variable auth, first/last-frame anchoring, and resumable paid tasks that are never submitted twice.
English | 简体中文 · Install · Quick start · Skills · Troubleshooting
Positioning
minimax-design runs MiniMax generation from a coding agent. It turns a request into H3 video (t2v, i2v, first/last-frame FL2VA, reference-image), music, speech, images, or text through a deterministic Python client or the vendored mmx toolkit, and it treats a paid async task as a durable record rather than a fire-and-forget call.
The default creative path is white-model previs anchoring: render first and last frames of each shot in Blender, then let H3 interpolate the motion between them. Prompts are drafted with the vendored h3-prompt-writing structures.
| Property | Value |
|---|
| Plugin ID | minimax-design |
| Version | 0.5.1+codex.20261018 |
| Maturity | Packaged release; no live provider acceptance record is stored in this repository |
| Runtime | Python 3 (standard library only); mmx CLI optional |
| MCP server | None; the executable client is scripts/minimax_video.py |
Installation
Prerequisites
- Python 3 on
PATH for scripts/minimax_video.py.
- A MiniMax API key from platform.minimax.cn (China) or platform.minimax.io (international). The gateway region must match the key.
- Optional: the
mmx CLI for toolkit generation, installed with npm install -g mmx-cli and signed in through mmx auth login --api-key.
- Optional: Blender white-model previs frames from the companion
blender-previs skill when you want FL2VA anchoring.
From the plugin marketplace
codex plugin marketplace add partme-ai/full-aigc-plugins
codex plugin add minimax-design@full-aigc-plugins
From the repository-local marketplace
codex plugin marketplace add full-aigc-plugins/minimax-design-plugin --ref v0.5.1
codex plugin add minimax-design@partme-ai-minimax-design
Restart the host and open a new task. ZCode loads the plugin through .zcode-plugin/plugin.json and auto-discovers hooks/hooks.json once; Kimi loads kimi.plugin.json with its declared hooks.
Configure the key
The client resolves the key in this order: process environment, project .env, plugin .env, then the user credential file. Persist it without editing your shell with:
python3 scripts/minimax_video.py auth --api-key sk-...
python3 scripts/minimax_video.py check
auth writes ~/.minimax-design/credentials.json with mode 600 (override the directory with MINIMAX_CONFIG_DIR). check reports the key source, gateway, model, and mmx status; it prints only the last four characters and never the full key.
Quick start
# Capability preflight: auth chain, gateway, model, mmx status
python3 scripts/minimax_video.py check
# Text to video; a ratio is mandatory for T2VA
python3 scripts/minimax_video.py generate --prompt "..." --ratio 16:9 --out shot-01.mp4
# First/last-frame FL2VA anchored by white-model previs frames
python3 scripts/minimax_video.py generate --first-frame first.png --last-frame last.png \
--prompt "continuous motion between the two frames" --out shot-01.mp4
# A polling timeout is not a failure: resume the same paid task
python3 scripts/minimax_video.py query --task-id <task-id>
generate takes --duration and --resolution. Model limits: MiniMax-H3 supports 480P/768P/2K and 4–15s; MiniMax-H3-Max supports 480P/768P and 5–15s. list and cancel operate on existing tasks, and the client never resubmits a paid task automatically.
What you can build
| Workflow | Built-in path | Verifiable output |
|---|
| Text-to-video | minimax-video-generation, generate --ratio | Downloaded MP4 plus a durable task ID |
| Image-to-video | generate --first-frame | MP4 anchored on the supplied first frame |
| First/last-frame shot | generate --first-frame --last-frame | MP4 interpolated between two previs frames |
| Reference-consistent subject | generate --reference-image | MP4 carrying the reference identity |
| Styled short from a brief | One of the eight style-generator skills | Shot plan, prompts, generated clips, assembly guidance |
| Music, speech, images | mmx toolkit or minimax-music-gen | Audio, image, or text artifacts in the chosen output directory |
Skills
| Skill | Purpose |
|---|
minimax-design-use | Runs the capability preflight first, then routes the request |
minimax-video-generation | H3 v2 workflows: t2v, i2v, FL2VA, reference-image |
minimax-multimodal-toolkit | mmx text, image, video, speech, music, and search |
minimax-music-gen | Songs, instrumentals, and background music |
minimax-music-playlist | Taste profiling and generated playlists |
h3-prompt-writing | T2VA, I2VA, FL2VA, L2VA, and Ref2VA prompt structures |
3d-animation-short-generator | End-to-end stylized 3D animated short |
brand-promo-video-generator | Brand and product promotional short |
co-op-game-intro-generator | Two-player co-op menu or opening animation |
handdrawn-live-video-generator | 15-second hand-drawn animation blended with live action |
minimalist-product-ad-generator | Minimalist e-commerce product ad |
music-video-subtitle-generator | Lyric typography and music-video shot plan |
paper-collage-explainer-generator | Halftone paper-collage explainer |
papercraft-stop-motion-explainer | Layered papercraft stop-motion explainer |
minimax-design-use and minimax-video-generation are plugin-local. The other twelve are vendored verbatim from minimax-skills v1.1.1 and pinned per skill by SHA-256 in skills.lock.json; edit neither copy in place.
Slash commands
| Command | What it does |
|---|
/minimax-check | Preflight auth chain, gateway, model, and mmx status |
/minimax-setup | Cross-platform key setup guidance and auth persistence |
/minimax-video | General H3 video request: t2v, i2v, or FL2VA |
/minimax-t2v | Text-to-video with a mandatory ratio |
/minimax-i2v | Image-to-video from one first frame |
/minimax-fl2va | First/last-frame anchoring; both frames required |
/minimax-ref2v | Reference-image video generation |
/minimax-episode | Fixed-format episode pipeline: shot table → per-shot generation → cut detection |
/minimax-image | Text-to-image with subject reference and batches |
/minimax-speech | Speech synthesis through the mmx toolkit |
/minimax-music | Song or BGM generation through the MiniMax music API |
Configuration
| Setting | Where it lives | Notes |
|---|
| API key | MINIMAX_API_KEY | Required; environment, .env, or the user credential file |
| Gateway | MINIMAX_API_HOST | Defaults to https://api.minimax.cn; use https://api.minimax.io for international accounts |
| Model | MINIMAX_MODEL | MiniMax-H3 by default; MiniMax-H3-Max for the faster tier |
| Credential directory | MINIMAX_CONFIG_DIR | Defaults to ~/.minimax-design, file mode 600 |
mmx credentials | ~/.mmx/credentials.json | Managed by mmx auth login, outside this plugin |
Real tokens never belong in a README, a prompt, a log, or a test fixture. The client prints the key source and the last four characters only, and check is advisory: it exits 0 and never blocks the session.
Architecture and security
flowchart LR
A[Request] --> B[Capability preflight]
B --> C{Key and gateway ready?}
C -->|no| D[Actionable setup guidance]
C -->|yes| E[Prompt drafting]
E --> F[H3 v2 client or mmx]
F --> G[(Persisted task ID)]
G --> H[Resumable query]
H --> I[Verified download]
| Component | Owns | Does not own |
|---|
scripts/minimax_video.py | Auth resolution, v2 submit/poll/download, auth persistence | Prompt quality |
scripts/vendor/skill_vendor.py | Immutable skill import and digest checks | Skill content |
hooks/env_check.py | Advisory session-start environment check | Blocking the session |
skills/ (14) | Routing, prompt structure, and production workflows | Runtime enforcement |
The plugin talks only to the MiniMax endpoints you configure and does not proxy or relay your traffic to the authors. Credentials stay in the host's sensitive configuration, environment variables, or the local credential file; they are not written into artifacts. Network calls use timeouts, and a paid task ID is persisted before polling so a timeout becomes a resumable query rather than a duplicate charge.
Troubleshooting
| Symptom | Check first | Resolution |
|---|
check reports no key | The resolution chain | Export MINIMAX_API_KEY, use project .env, or run auth --api-key |
| Authentication fails | Gateway and key region | Match MINIMAX_API_HOST to the account region |
| Video task times out | The persisted task ID | Query the same task; never resubmit a paid job |
mmx commands are missing | CLI installation | npm install -g mmx-cli, then mmx auth login --api-key |
| Model or duration rejected | Model matrix | H3 supports 480P/768P/2K and 4–15s; H3-Max supports 480P/768P and 5–15s |
| FL2VA has no anchor frames | Previs input | Render first and last frames first, or use /minimax-i2v |
Upgrade
codex plugin marketplace upgrade partme-ai-minimax-design
codex plugin add minimax-design@partme-ai-minimax-design
Contributing and support
Open functional issues at https://github.com/full-aigc-plugins/minimax-design-plugin/issues. Before proposing a change, state the host you verified, whether it alters the credential chain or the model matrix, and include the affected checks.
License
Apache-2.0 — see LICENSE, NOTICE, and THIRD_PARTY_NOTICES.md. Vendored skills keep their own licenses.
