API Endpoints

MiniMax Provider

POST/v2/minimax/generate

MiniMax Provider Generate API

Generate music through the integrated MiniMax provider.

POSThttps://udioapi.pro/api/v2/minimax/generate

tips

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

namerequireddescription
AuthorizationyesBearer token for authentication
Content-Typeyesapplication/json

requestBody

MiniMax generation request

commonParams

paramNameparamTyperequireddescriptionexample
promptstringyesMusic generation promptCinematic orchestral pop, emotional female vocal, warm piano, strings, gradual build, polished studio mix.
lyricsstringnoOptional lyricsVerse 1: The city lights are fading\nChorus: We rise into the morning glow
bitratenumbernoAudio bitrate256000
sample_ratenumbernoAudio sample rate44100
callback_urlstringnoOptional callback URLhttps://api.example.com/webhooks/minimax
publicbooleannoWhether task can be publicfalse

Response Fields

Generate Response

fieldparamTypedescriptionexample
codenumberResponse code. 200 means the task was created successfully.200
messagestringHuman-readable response message.success
data.task_idstringMiniMax generation task ID. Use it as workId when polling the feed endpoint.n74abc123music
data.statusstringInitial task status.IN_PROGRESS

responses

json
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n74abc123music",
    "status": "IN_PROGRESS",
    "type": "text2music"
  }
}
json
{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}
json
{
  "code": 401,
  "message": "No API key provided in Authorization header",
  "data": null
}

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"
  }'
javascript
const response = await fetch('https://udioapi.pro/api/v2/minimax/generate', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    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'
  })
});

const data = await response.json();
console.log(data.data.task_id);
GET/v2/minimax/feed?workId=xxx

MiniMax Provider Task Status API

Fetch status and result URLs for a MiniMax task.

GEThttps://udioapi.pro/api/v2/minimax/feed?workId=xxx

tips

Use task_id from generate endpoint as workId.

When status becomes SUCCESS, response contains audio URLs.

requestParams

paramNameparamTyperequireddescription
workIdstringyesMiniMax task ID returned from generate endpoint

responses

json
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n74abc123music",
    "status": "IN_PROGRESS",
    "consumed_credits": 30,
    "error_message": null,
    "created_at": "2026-06-13 12:00:00",
    "type": "text2music",
    "request": {
      "prompt": "Cinematic orchestral pop...",
      "bitrate": 256000,
      "sample_rate": 44100
    },
    "response": null
  }
}
json
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n74abc123music",
    "status": "SUCCESS",
    "consumed_credits": 30,
    "error_message": null,
    "created_at": "2026-06-13 12:00:00",
    "type": "text2music",
    "request": {
      "prompt": "Cinematic orchestral pop...",
      "bitrate": 256000,
      "sample_rate": 44100
    },
    "response": [
      "https://example-cdn.com/generated-minimax-track.mp3"
    ]
  }
}
json
{
  "code": 404,
  "message": "Task not found",
  "data": null
}

codeExamples

curl
curl -X GET "https://udioapi.pro/api/v2/minimax/feed?workId=n74abc123music"
javascript
const response = await fetch('https://udioapi.pro/api/v2/minimax/feed?workId=n74abc123music');
const data = await response.json();

if (data.data.status === 'SUCCESS') {
  console.log('Audio URLs:', data.data.response);
}