appnz-music-api

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

1. Choose app/auto or a modality-specific auto model when possible.
2. For exact provider routing, call GET /api/gateway/resolve?model=MODEL.
3. For provider-owned billing, store BYOK first with /api/gateway/provider-keys.
4. Run the request and inspect X-Gateway-Provider and X-Gateway-Model for routed upstream details.
5. 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	-