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
| Name | Type | Details |
|---|---|---|
promptrequired | string | 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_seconds | number | Upper bound on the generated audio length in seconds. The model may stop earlier; the actual duration is returned in the output. Default: Min 1 · Max 300 |
seed | number | Random seed for reproducibility. If not provided, a random seed will be used. |
guidance | number | Classifier-free guidance scale of the flow-matching stage. Default: Min 0 · Max 20 |
steps | number | Number of flow-matching Euler steps per 8-second denoising chunk. More steps improve quality at the cost of speed. Default: Min 1 · Max 100 |
lyricsrequired | string | 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. |