한 번의 REST 호출로 쓰는 MiniMax Music 2.5
MiniMax Music API는 플랫폼 전체와 동일한 계정, API 키, 비동기 태스크 모델을 통해 MiniMax Music 2.5를 제공합니다. 원하는 트랙을 설명하는 프롬프트와 가사(MiniMax Music 2.5 필수, 10–3000자)를 함께 보내면 엔드포인트가 즉시 task_id를 반환합니다.
결과는 전용 MiniMax feed 엔드포인트로 도착합니다. task_id로 GET /v2/minimax/feed?workId=...를 상태가 SUCCESS 또는 FAILED가 될 때까지 폴링하거나, callback_url을 전달해 플랫폼이 최종 결과를 webhook으로 POST하게 하세요. 완료된 태스크는 response 필드에 생성된 오디오 URL을 반환합니다.
빠른 시작: 생성 후 feed 확인
/v2/minimax/generate에 POST하고, 반환된 task_id를 저장한 뒤 곡이 준비될 때까지 MiniMax feed를 쿼리하세요.
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",
"lyrics": "Verse 1: The city lights are fading\nChorus: We rise into the morning glow"
}'
curl -X GET "https://udioapi.pro/api/v2/minimax/feed?workId=YOUR_TASK_ID"5~10초 간격으로 제한된 시간 내 폴링하세요. 선택적 bitrate와 sample_rate 매개변수가 출력 인코딩을 제어합니다.
MiniMax Music 2.5 요청 매개변수
generate 엔드포인트는 간결한 매개변수 집합을 받습니다. 요청 한 번에 30크레딧 — 1 USD = 100 크레딧 기준 약 $0.30입니다.
| 매개변수 | 유형 | 필수 | 비고 |
|---|---|---|---|
| prompt | string | 필수 | 트랙 설명 — 장르, 분위기, 편성 |
| lyrics | string | 필수 | 10–3000자. MiniMax Music 2.5 필수 |
| bitrate | number | 선택 | 오디오 비트레이트(예: 256000) |
| sample_rate | number | 선택 | 오디오 샘플레이트(예: 44100) |
| callback_url | string | 선택 | 최종 결과를 받을 공개 HTTPS webhook |
| public | boolean | 선택 | 태스크 공개 여부 |
응답은 data.task_id와 상태 IN_PROGRESS를 반환합니다. 상태가 SUCCESS(response에 오디오 URL) 또는 FAILED가 될 때까지 /v2/minimax/feed?workId=<task_id>를 쿼리하세요.
무엇을 만들 수 있나요
MiniMax 태스크는 오디오 API의 나머지 부분과 함께 동작합니다.
가사 그대로의 곡
전체 가사(10–3000자 필수)와 스타일 프롬프트로 확정적인 보컬 콘텐츠를 얻습니다.
문서 읽기보컬 또는 인스트루멘털 트랙
프롬프트로 장르, 분위기, 편곡을 조정하고 작곡은 모델에 맡깁니다.
문서 읽기여러 엔진, 하나의 키
다른 사운드가 필요할 때 같은 API 키로 /v2/generate의 chirp-v6 패밀리도 호출할 수 있습니다.
문서 읽기생성된 곡 연장
원본 태스크가 완료되면 extend 엔드포인트로 대상 트랙을 이어갈 수 있습니다.
문서 읽기WAV 변환
생성된 오디오를 WAV로 변환해 프로덕션 파이프라인에 전달합니다.
문서 읽기콜백과 상태
MiniMax feed를 폴링하거나 callback_url로 결과를 인프라에 전달합니다.
문서 읽기작동 방식
API 키에서 재생 가능한 트랙까지 네 단계.
- 1
API 키 생성
로그인 후 대시보드에서 키를 복사하세요. 서버 측 비밀로 보관하고 브라우저 코드에는 절대 넣지 마세요.
- 2
프롬프트와 가사 제출
prompt, lyrics 및 선택적 인코딩 필드를 /v2/minimax/generate에 POST합니다. data.task_id를 저장하세요.
- 3
MiniMax feed 폴링
5~10초마다 GET /v2/minimax/feed?workId=<task_id>를 호출하거나 callback_url로 webhook을 받습니다.
- 4
오디오 다운로드
SUCCESS가 되면 response 필드에 오디오 URL이 들어옵니다. 자체 스토리지에 저장하세요.
제한 및 참고 사항
- 생성은 비동기입니다. POST는 오디오가 아닌 task_id를 반환합니다.
- MiniMax Music 2.5는 lyrics가 필수이며 10–3000자여야 합니다.
- /v2/minimax/feed를 5~10초 간격으로 제한된 시간 내 폴링하거나 callback_url을 사용하세요.
- 오디오 URL은 임시입니다. 결과를 자체 스토리지에 다운로드하세요.
- MiniMax는 추가 엔진입니다. 기본 음악 생성 엔드포인트는 /v2/generate로 유지됩니다.
udioapi.pro는 독립적인 제3자 서비스입니다. Suno, Udio, MiniMax와 제휴하거나 보증받거나 운영되지 않습니다.
MiniMax Music API FAQ
매개변수, 과금, 비동기 워크플로에 대한 답변.
이것이 MiniMax 공식 API인가요?
아니요. udioapi.pro는 자체 엔드포인트, 계정, 크레딧, 약관, 지원을 갖춘 독립적인 제3자 API 서비스입니다. MiniMax, Suno, Udio와 제휴하거나 보증받거나 운영되지 않습니다.
MiniMax Music 2.5 요청 비용은 얼마인가요?
/v2/minimax/generate 요청 한 번에 30크레딧 — 1 USD = 100 크레딧 기준 약 $0.30입니다.
가사는 필수인가요?
네. MiniMax Music 2.5는 10–3000자의 lyrics 필드가 필수입니다. 가사가 없거나 유효하지 않은 요청은 400 응답으로 거부됩니다.
결과는 어떻게 받나요?
generate 응답이 data.task_id를 반환합니다. 5~10초마다 GET /v2/minimax/feed?workId=<task_id>를 SUCCESS까지 폴링하거나 callback_url로 webhook을 받으세요. 오디오 URL은 response 필드에 나타납니다.
어떤 상태가 표시되나요?
태스크는 IN_PROGRESS로 시작해 SUCCESS 또는 FAILED로 끝납니다. 실패한 태스크는 feed에서 error_message를 보고하며, 거부된 요청은 완료 태스크로 과금되지 않습니다.
초안용으로 더 저렴한 모델이 있나요?
네. /v2/generate의 chirp-v6 패밀리에는 요청당 10크레딧인 chirp-v6-mini가 있어 프로토타이핑용 빠르고 경제적인 티어입니다.