| name | appnz-music-api |
| description | Use this skill for app.nz music generation via /v1/music/generations, including Google Lyria and MiniMax music models routed through the same app.nz key. |
app.nz Music API
Use POST /v1/music/generations on app.nz. Authenticate with an app.nz bearer key unless the endpoint is explicitly public.
Workflow
- Choose
app/auto or a modality-specific auto model when possible.
- For exact provider routing, call
GET /api/gateway/resolve?model=MODEL.
- For provider-owned billing, store BYOK first with
/api/gateway/provider-keys.
- Run the request and inspect
X-Gateway-Provider and X-Gateway-Model for routed upstream details.
- Check
/api/usage when the user asks about spend.
Example
curl -sX POST https://app.nz/v1/music/generations \
-H "Authorization: Bearer pk_live_..." \
-H "Content-Type: application/json" \
-d '{"model":"lyria-3-clip-preview","prompt":"Upbeat synthwave loop, 20 seconds"}'
Relevant Models
| Model | Modality | Aliases | Caps |
|---|
| lyria-3-clip-preview | music | lyria-clip, google-lyria-clip | - |
| lyria-3-pro-preview | music | lyria-pro, google-lyria-pro | - |
| music-2.0 | music | - | - |
| music-2.5 | music | minimax-music | - |
