Mage API · Audio model
MiniMax Music 3 API
Full songs from your lyrics, open weights
POST https://api.mage.space/v1/minimax_music/generateAt a glance
The MiniMax Music 3 API runs MiniMax Music 3 through Mage at POST https://api.mage.space/v1/minimax_music/generate. A request at the default settings costs 125 Gems (about $0.125), with no subscription. MiniMax Music 3 takes no @handle mentions.
- AudioOutput
- 1Variant
- 125Gems per clip, default
- $0.125About, in USD
Overview
What the MiniMax Music 3 API does
MiniMax's open song model: complete songs up to 5 minutes with vocals that sing your lyrics, or instrumentals, shaped by a description of the genre, voice, and arrangement. With LoRAs.
MiniMax's open-weights song model: complete songs with sung vocals that follow your lyrics, or instrumentals, up to 5 minutes, as a 44.1 kHz stereo MP3, with LoRAs. Put the words in `lyrics` and the sound in the prompt.
It generates from the prompt alone.
Quick start
Call the MiniMax Music 3 API
Set MAGE_API_KEY, submit to /minimax_music/generate, and poll status_url until the request completes.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/minimax_music/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.",
"duration": "120",
"lyrics": "[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe",
"model_id": "minimax-music-3"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('minimax_music', {
prompt: 'Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.',
duration: '120',
lyrics: '[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe',
model_id: 'minimax-music-3',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("minimax_music", {
"prompt": "Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.",
"duration": "120",
"lyrics": "[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe",
"model_id": "minimax-music-3",
})
print(request["result"]["url"])Models
MiniMax Music 3 model_id values
Send model_id to pick a variant. A request without one runs the default.
| model_id | Name | Default |
|---|---|---|
| minimax-music-3 | MiniMax Music 3 | Yes |
Options
MiniMax Music 3 parameters
Allowed values across all variants; a variant may offer fewer. The docs list the options per variant.
| Field | Values |
|---|---|
| duration | 30, 60, 120, 180, 240, 300 |
Rules
What the MiniMax Music 3 API enforces
- The prompt describes the music, at most 4000 characters: genre, tempo and key, mood and how it builds, the vocalist (name the voice, or the song may come out instrumental), and the instruments.
- `lyrics` holds the words to sing, at most 6000 characters. Put each section tag ([intro], [verse], [pre-chorus], [chorus], [bridge], [outro]) on its own line: words on a tag's line are dropped.
- Leave `lyrics` empty, or set `instrumental` to true, for an instrumental.
- `duration` is the longest the song may run, and the price; the model ends the song when its lyrics and arrangement are done, often sooner.
More audio models
Other audio generation APIs on Mage
Seed Audio API
Voices, music, and sound effects from one prompt
Eleven Music API
ElevenLabs songs, with vocals or without
Eleven Speech API
ElevenLabs v4: lifelike speech you can direct
FAQ
Frequently asked questions
How much does the MiniMax Music 3 API cost?
What is the MiniMax Music 3 API endpoint?
Which MiniMax Music 3 models can I call?
Does MiniMax Music 3 support reference images or characters?
Can I use MiniMax Music 3 from Claude or ChatGPT?
How long are MiniMax Music 3 results kept?
Start building with Mage
One account, one Gems balance, every model. Pay only for what you generate.