API 엔드포인트

MiniMax 제공업체

POST/v2/minimax/generate

MiniMax 공급자 생성 API

통합 MiniMax 공급자를 통해 음악을 생성합니다.

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

tips

MiniMax 제공자: MiniMax가 필요할 때 이 엔드포인트를 사용하십시오.

폴링: SUCCESS 또는 FAILED가 될 때까지 /v2/minimax/feed?workId=...를 호출하세요.

requestHeaders

namerequireddescription
Authorizationyes인증을 위한 Bearer 토큰
Content-Typeyesapplication/json

requestBody

MiniMax 생성 요청

commonParams

paramNameparamTyperequireddescriptionexample
promptstringyes음악 생성 프롬프트Cinematic orchestral pop, emotional female vocal, warm piano, strings, gradual build, polished studio mix.
lyricsstringno선택적 가사Verse 1: The city lights are fading\nChorus: We rise into the morning glow
bitratenumberno오디오 비트레이트256000
sample_ratenumberno오디오 샘플링 속도44100
callback_urlstringno선택적 콜백 URLhttps://api.example.com/webhooks/minimax
publicbooleanno작업을 공개할 수 있는지 여부false

endpoint.generate.responseSectionsHeading

endpoint.generate.responseSections.generateResponse.title

fieldparamTypedescriptionexample
codenumberendpoint.generate.responseSections.generateResponse.fields.code.description200
messagestringendpoint.generate.responseSections.generateResponse.fields.message.descriptionsuccess
data.task_idstringendpoint.generate.responseSections.generateResponse.fields.dataTaskId.descriptionn74abc123music
data.statusstringendpoint.generate.responseSections.generateResponse.fields.dataStatus.descriptionIN_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 공급자 작업 상태 API

MiniMax 작업에 대한 상태 및 결과 URL을 가져옵니다.

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

tips

생성 엔드포인트의 task_idworkId로 사용하세요.

상태가 SUCCESS가 되면 응답에 오디오 URL이 포함됩니다.

requestParams

paramNameparamTyperequireddescription
workIdstringyes엔드포인트 생성에서 반환된 MiniMax 작업 ID

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);
}