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 |
|---|---|---|
Authorization | yes | Bearer token for authentication |
Content-Type | yes | application/json |
requestBody
MiniMax generation request
commonParams
| paramName | paramType | required | description | example |
|---|---|---|---|---|
prompt | string | yes | Music generation prompt | Cinematic orchestral pop, emotional female vocal, warm piano, strings, gradual build, polished studio mix. |
lyrics | string | no | Optional lyrics | Verse 1: The city lights are fading\nChorus: We rise into the morning glow |
bitrate | number | no | Audio bitrate | 256000 |
sample_rate | number | no | Audio sample rate | 44100 |
callback_url | string | no | Optional callback URL | https://api.example.com/webhooks/minimax |
public | boolean | no | Whether task can be public | false |
Response Fields
Generate Response
| field | paramType | description | example |
|---|---|---|---|
code | number | Response code. 200 means the task was created successfully. | 200 |
message | string | Human-readable response message. | success |
data.task_id | string | MiniMax generation task ID. Use it as workId when polling the feed endpoint. | n74abc123music |
data.status | string | Initial task status. | IN_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"
}'