MiniMax Music 3 via Fal.AI. Generates complete songs with vocals up to five minutes long from a music description (genre, mood, BPM, key, vocals, arrangement) and structured lyrics. Returns 44.1 kHz stereo WAV.
Test this model instantly in the Console Playground โ no code required
Copy usage instructions for Claude, ChatGPT, or other AI
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "minimax/music-3",
"input": {
"prompt": "Genre: acoustic pop. BPM: 96. Key: C major. Warm and intimate, building gently into the chorus. Vocals: soft female lead, close and breathy, light stacked harmonies in the chorus. Arrangement: fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.",
"lyrics": "[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe",
"duration": 60
}
}'| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | - | Music description: style, mood, vocals, instrumentation and arrangement. For precise control, use a structured caption (genre, BPM, key, emotional progression, vocal details, section-by-section arrangement). |
lyrics | string | Yes | - | The lyrics to sing. Structure tags such as [intro], [verse], [pre-chorus], [chorus], [bridge], [instrumental], [solo] and [outro] must each be on their own line. |
duration | number | No | 60 | Upper bound on the generated audio length in seconds (1-300). Billed per second of this requested value; the actual length is returned in the output. |
num_inference_steps | integer | No | 30 | Flow-matching steps per 8-second chunk (1-100). More steps improve quality at the cost of speed. |
guidance_scale | number | No | 1.7 | Classifier-free guidance scale of the flow-matching stage (0-20). |
seed | integer | No | - | Random seed for reproducibility. A random seed is used when omitted. |
Common parameters used when calling POST /v1/predictions.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
model | string | Yes | - | Model identifier |
input | object | Yes | - | Object containing the model-specific parameters from the table above |
output_folder | string | No | - | Folder path for output files (max 256 chars, '..' not allowed) |
webhook_url | string | No | - | Webhook URL to call on completion |
is_public | boolean | No | false | If true, output files are also available via permanent public URLs |
A one-minute acoustic pop song driven by a structured caption and tagged lyrics.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "minimax/music-3",
"input": {
"prompt": "Genre: acoustic pop. BPM: 96. Key: C major. Warm and intimate, building gently into the chorus. Vocals: soft female lead, close and breathy, light stacked harmonies in the chorus. Arrangement: fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.",
"lyrics": "[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe",
"duration": 60
}
}'A 20-second jingle โ a shorter duration also lowers the charge.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "minimax/music-3",
"input": {
"prompt": "Genre: upbeat synth-pop jingle. BPM: 120. Bright male and female duet, catchy hook.",
"lyrics": "[chorus]\nOne key, every model\nBuild it today",
"duration": 20
}
}'POST /v1/predictions