API docs / Audio models

MiniMax Music 3 API

Generate a complete song from lyrics and a structured music description.

Model id
minimax/music-3
Provider
MiniMax
Output
Audio
Price
From 42 credits per run, the same as on voor.ai. Options such as length or resolution can change it.

Request

POST https://voor.ai/v1/generations with "model": "minimax/music-3". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "minimax/music-3",
  "input": {
    "prompt": "A red fox standing in fresh snow at golden hour, soft light",
    "lyrics": "example"
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
promptrequiredstring

Music description: style, mood, vocals, instrumentation and arrangement. For precise control use a Structured Caption with global metadata (genre, BPM, key, emotional progression), vocal details, and a section-by-section arrangement.

duration_secondsnumber

Upper bound on the generated audio length in seconds. The model may stop earlier; the actual duration is returned in the output.

Default: 60

Min 1 · Max 300

seednumber

Random seed for reproducibility. If not provided, a random seed will be used.

guidancenumber

Classifier-free guidance scale of the flow-matching stage.

Default: 1.7

Min 0 · Max 20

stepsnumber

Number of flow-matching Euler steps per 8-second denoising chunk. More steps improve quality at the cost of speed.

Default: 30

Min 1 · Max 100

lyricsrequiredstring

The lyrics to sing. Structure tags such as [intro], [verse], [pre-chorus], [chorus], [post-chorus], [bridge], [instrumental], [solo] and [outro] must each be on their own line; text on the same line as a leading tag is dropped by the model's input contract.