MiniMax Music 3.0 API

SpicyAPI의 MiniMax Music 3.0은 요청 한 번에 완성곡 한 곡을 돌려주는 텍스트 투 뮤직 작업입니다. 리드 보컬, 반주 편곡, 최종 믹스가 스테레오 MP3 하나에 담겨 나옵니다. prompt에 스타일 설명을 보내고, 부를 lyrics가 있다면 lyrics에 함께 보내면 멜로디, 편곡, 연주는 모델이 맡습니다. 저희 테스트에서 곡은 1:09에서 3:58 사이로 나왔고, 어떤 곡이든 요금은 같은 정액입니다.

루프가 아닌 한 곡 전체

결과물은 짧게 반복되는 클립이 아니라 인트로, 벌스, 다시 돌아오는 후렴, 마무리까지 갖춘 구조적인 노래입니다. 길이는 모델이 정하며, 주로 입력한 lyrics의 분량에 따라 달라집니다. 보컬과 반주는 바로 재생할 수 있는 완성된 스테레오 파일 하나로 믹스됩니다.

가사를 다루는 세 가지 방법

직접 쓴 lyrics를 부르게 하거나, 모델에게 lyrics를 쓰게 하거나, 가수를 빼고 연주곡만 만들 수 있습니다. 입력한 lyrics는 쓴 그대로 불리며, [Verse], [Chorus] 같은 섹션 태그로 편곡을 조정할 수 있습니다. lyrics가 비어 있으면 generate_lyrics(기본값 켜짐)가 prompt를 바탕으로 가사 전체를 씁니다. instrumental을 켜면 트랙에 보컬이 전혀 들어가지 않습니다.

정액 요금, 조절 가능한 파일 품질

길이, bitrate, sample_rate는 곡의 요금에 영향을 주지 않습니다. 마스터용으로는 44.1 kHz의 256 kbps를, 작은 미리듣기 파일에는 더 낮은 비트레이트를 선택하세요.

내가 쓴 가사로 만드는 노래

lyrics를 먼저 쓰고 섹션에 태그를 붙인 다음, 머릿속에 그리는 장르와 목소리를 설명하세요. 맞춤형 노래, 이야기나 게임 속 캐릭터 테마곡, 패러디 곡, 본격적으로 다듬기 전에 lyrics를 노래로 들어 보는 러프 데모에 어울립니다.

영상과 스트림용 음악

배경음악, 라운지 배경음, 인트로 음악에는 instrumental을 켜고, 타이틀송에는 보컬을 살리세요. 1~4분 길이의 트랙이면 대부분의 짧은 영상을 요청 한 번으로 채울 수 있고, 정액 요금이라 여러 테이크를 생성해 가장 좋은 것을 고르기에도 부담이 적습니다.

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_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
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.