Create a song
minimax_create_musicGenerate 1-3 songs with MiniMax Music (music-3.0, music-2.6) from a style prompt, your own lyrics, or a reference track (a cover); for spoken text use minimax_create_speech. Supply prompt, lyrics, referenceMusicId or a combination. One song generation per MiniMax account at a time (429 while one runs, including songs started on minimax.io); uses the account's MiniMax Audio credits, not its Hailuo video credits (412 without them). Waits up to ~50 s and returns each track's musicId, status and, once completed, audio_url; else call minimax_get_music. POST /music/create.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "minimax_create_music"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Wait up to ~50 s for the job to finish (default true); false returns the id at once. | |
| model | No | Default music-3.0. | |
| title | No | Song name, max 40 characters. | |
| lyrics | No | Your own lyrics, max 3500 characters; structure tags on their own line ([Verse], [Chorus], [Bridge], [Outro]...). Left out, the model writes lyrics from prompt (MiniMax may refuse with 422: add lyrics, set instrumental, or rephrase). More lyrics make a longer song: there is no duration input. Not with instrumental. | |
| prompt | No | Style and subject in one: genre, mood, tempo, instruments, vocal type, and what the song is about. Max 2000 characters. | |
| account | No | The MiniMax account id (minimax_list_accounts). Omit to let the API pick the account with the fewest music generations running; with referenceMusicId the reference's account is used. | |
| quantity | No | Tracks from this one call, 1-3 (default 1); each is its own song with its own musicId and finishes on its own. | |
| replyRef | No | Optional reference of yours, stored and returned with the result and webhook. Up to 1,024 characters. | |
| replyUrl | No | Optional webhook: the API POSTs the finished result (same shape as the get tool's record) to this URL. Up to 1,024 characters. | |
| instrumental | No | true: no vocals (leaving lyrics empty is not enough). Cannot be combined with lyrics or referenceMusicId. Default false. | |
| referenceMusicId | No | The musicId of a track the new song should follow, making it a cover: a reference from minimax_upload_music_reference or any song on the same account. The cover runs on that account. For the closest result pass the reference's own lyrics and no prompt, e.g. user:12345-minimax:123456789012345678-music:987654321098765 (it names the account). |