| name | appnz-provider-minimax |
| description | Use this skill when the user asks to use MiniMax, provider minimax, or any minimax model through app.nz; covers model selection when present, BYOK setup, OpenAI-compatible routing, provider-specific endpoints, aliases, and debugging gateway headers. |
MiniMax on app.nz
Route MiniMax through app.nz with one app.nz key. Use this skill when a user asks for MiniMax, minimax, one of its model ids, aliases, product integrations, or BYOK setup for this provider.
Workflow
- Use
/api/gateway/models?provider=minimax to confirm the current public model list if exact availability matters.
- Call app.nz at
https://app.nz/v1 with Authorization: Bearer pk_live_...; do not call https://api.minimax.io directly unless the user explicitly asks to bypass app.nz.
- Store a user-owned upstream key with
POST /api/gateway/provider-keys using provider minimax when BYOK is required. The upstream secret is never returned by app.nz.
- Prefer a model matching the task modality. If unsure, start with
minimax-m2.5-direct or app/auto.
- Read
X-Gateway-Provider and X-Gateway-Model response headers when debugging routing.
BYOK
curl -sX POST https://app.nz/api/gateway/provider-keys \
-H "Authorization: Bearer pk_live_..." \
-H "Content-Type: application/json" \
-d '{"provider":"minimax","api_key":"REDACTED_UPSTREAM_KEY"}'
Chat Example
curl -s https://app.nz/v1/chat/completions \
-H "Authorization: Bearer pk_live_..." \
-H "Content-Type: application/json" \
-d '{"model":"minimax-m2.5-direct","messages":[{"role":"user","content":"Give me one practical idea."}]}'
Models
| Model | Modality | Aliases | Caps |
|---|
| auto-video | video | auto-vid | - |
| hailuo-02 | video | - | - |
| hailuo-2.3 | video | hailuo, minimax-video | - |
| hailuo-2.3-fast | video | hailuo-fast | - |
| minimax-m2 | chat | - | stream, tools |
| minimax-m2.1 | chat | - | stream, tools |
| minimax-m2.5-direct | chat | mm-m2.5 | stream, tools |
| minimax-m2.5-highspeed | chat | mm-fast | stream, tools |
| music-2.0 | music | - | - |
| music-2.5 | music | minimax-music | - |
| speech-2.6-hd | speech | - | - |
| speech-2.6-turbo | speech | - | - |
| speech-2.8-hd | speech | minimax-tts-hd, tts-hd | - |
| speech-2.8-turbo | speech | minimax-tts, tts-turbo | - |
