요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
lyrics | 아니요 | 가사를 직접 쓰거나 모델에 맡깁니다. |
prompt | 예 | Style brief for the song: genre, mood, tempo, instruments and the kind of voice. The words to sing go in lyrics. |
bitrate | 아니요 | MP3 bitrate in bits per second. 32000 · 64000 · 128000 · 256000 · 기본값: 256000 |
sample_rate | 아니요 | Sample rate in Hz. 16000 · 24000 · 32000 · 44100 · 기본값: 44100 |
instrumental | 아니요 | 보컬 없이 음악만. 기본값: false |
generate_lyrics | 아니요 | Write lyrics from the prompt when lyrics is empty. Lyrics you send are sung as written. 기본값: true |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /회 | ≈ USD |
|---|---|---|
| 기본 | 27 | US$0.27 |
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
MiniMax Music 3.0 API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 minimax/music-3.0/text-to-audio, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/music-3.0/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif",
"bitrate": 256000,
"sample_rate": 44100
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
MiniMax Music 3.0 API 질문
MiniMax Music 3.0 API 요금은 얼마인가요?
MiniMax Music 3.0 가격은 27크레딧(US$0.27) /회입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 MiniMax Music 3.0의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 음악: minimax/music-3.0/text-to-audio을(를) 넣으세요.
노래는 얼마나 긴가요?
모델이 정합니다. 저희 테스트에서 곡 길이는 1:09에서 3:58까지였고, 대부분 lyrics의 분량에 따라 달라졌습니다. 길이를 지정하는 필드는 없습니다.
lyrics를 꼭 써야 하나요?
아니요. lyrics를 비워 두면 모델이 prompt를 바탕으로 lyrics를 씁니다(generate_lyrics는 기본값이 켜짐). 보컬이 없는 음악을 원하면 instrumental을 켜세요. 직접 입력한 lyrics는 쓴 그대로 불립니다.
곡 구조를 제어할 수 있나요?
네. lyrics에서 [Intro], [Verse], [Pre Chorus], [Chorus], [Bridge], [Outro] 같은 섹션 태그를 각각 별도의 줄에 넣으면 편곡이 그 구조를 따릅니다.
곡 하나를 생성하는 데 얼마나 걸리나요?
저희 실행에서는 약 1분 30초에서 4분이 걸렸습니다. lyrics를 자동으로 쓰는 곡이 가장 오래 걸립니다.
MiniMax Music 3.0 API의 제한은 무엇인가요?
프롬프트 길이(글자): 2,000. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 MiniMax Music 3.0을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 MiniMax Music 3.0을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
모든 MiniMax 모델
- MiniMax H3 API표현력 있는 오디오 포함 클립, 최대 2K28크레딧부터 / 5초 영상
- MiniMax Speech 2.8 HD API400가지 이상 목소리의 고음질 음성, 감정 조절18크레딧부터 /1,000자
- MiniMax Music 3.0 API보컬 또는 연주곡으로 완성된 스테레오 곡27크레딧부터 /회
- MiniMax H3 Singularity LoRA API커뮤니티 튜닝 H3 영상, 내 LoRA 불러오기45크레딧부터 / 5초 영상
- MiniMax H3 Max API앰비언스·효과음·음악까지 담은 빠른 클립38크레딧부터 / 5초 영상
- MiniMax H3 LoRA API사운드 포함 MiniMax H3 영상, 내 LoRA 최대 3개38크레딧부터 / 5초 영상
- MiniMax H3 Image LoRA APIH3 스틸과 편집, 내 LoRA 최대 3개7크레딧부터 /장
- MiniMax Speech 2.8 Turbo API400가지 이상 목소리의 빠른 음성, 감정 조절11크레딧부터 /1,000자

