POST
/v2/minimax/generateMiniMax Provider Generate API
Generate music through the integrated MiniMax provider.
POST
https://udioapi.pro/api/v2/minimax/generatetips
MiniMax provider: Use this endpoint only when you specifically want the integrated MiniMax provider. The default Music Generate flow remains /v2/generate.
Provider task: This route creates an async MiniMax task and returns a task_id.
Credit cost: 30 credits per generation request.
Polling: Call /v2/minimax/feed?workId=... every 5-10 seconds until the task is SUCCESS or FAILED.
Callback: Pass callback_url to receive a POST notification when the task reaches SUCCESS or FAILED.
requestHeaders
| name | required | description |
|---|---|---|
nameAuthorization | requiredyes | descriptionBearer token for authentication |
nameContent-Type | requiredyes | descriptionapplication/json |
requestBody
MiniMax generation request
commonParams
| paramName | paramType | required | description | example |
|---|---|---|---|---|
paramNameprompt | paramTypestring | requiredyes | descriptionMusic generation prompt | exampleCinematic orchestral pop, emotional female vocal, warm piano, strings, gradual build, polished studio mix. |
paramNamelyrics | paramTypestring | requiredno | descriptionOptional lyrics | exampleVerse 1: The city lights are fading\nChorus: We rise into the morning glow |
paramNamebitrate | paramTypenumber | requiredno | descriptionAudio bitrate | example256000 |
paramNamesample_rate | paramTypenumber | requiredno | descriptionAudio sample rate | example44100 |
paramNamecallback_url | paramTypestring | requiredno | descriptionOptional callback URL | examplehttps://api.example.com/webhooks/minimax |
paramNamepublic | paramTypeboolean | requiredno | descriptionWhether task can be public | examplefalse |
Response Fields
Generate Response
| field | paramType | description | example |
|---|---|---|---|
fieldcode | paramTypenumber | descriptionResponse code. 200 means the task was created successfully. | example200 |
fieldmessage | paramTypestring | descriptionHuman-readable response message. | examplesuccess |
fielddata.task_id | paramTypestring | descriptionMiniMax generation task ID. Use it as workId when polling the feed endpoint. | examplen74abc123music |
fielddata.status | paramTypestring | descriptionInitial task status. | exampleIN_PROGRESS |
responses
json
{
"code": 200,
"message": "success",
"data": {
"task_id": "n74abc123music",
"status": "IN_PROGRESS",
"type": "text2music"
}
}codeExamples
curl
curl -X POST "https://udioapi.pro/api/v2/minimax/generate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Cinematic orchestral pop, emotional female vocal, warm piano, strings, gradual build, polished studio mix.",
"lyrics": "Verse 1: The city lights are fading\nChorus: We rise into the morning glow",
"bitrate": 256000,
"sample_rate": 44100,
"callback_url": "https://api.example.com/webhooks/minimax"
}'