MiniMax

MiniMax Music 1.5

minimax-music-1.5

텍스트-투-뮤직 모델로, 스타일 설명과 가사를 입력하면 보컬과 반주가 포함된 완성된 곡을 한 번에 생성하며, 곡당 최대 약 4분 길이를 지원하고 구조 태그로 구간을 나누어 편곡할 수 있습니다

minimax-music-1.5

minimax-music-1.5 사용해 보기

입력

Lyrics

작품 갤러리

모든 작품 보기

출력

파라미터를 입력하고 생성하면 결과가 여기에 표시됩니다.

가격

minimax-music-1.5 per song

단가	$0.070

포지셔닝 소개

minimax-music-1.5는 MiniMax의 텍스트-투-뮤직 모델로, HiAPI.ai 통합 인터페이스를 통해 호출할 수 있습니다. 스타일 프롬프트와 구조 태그가 포함된 가사를 입력하면 보컬과 레이어드된 기악이 포함된 완성 곡을 생성하며, 편곡·믹싱·보컬은 모델이 처리하므로 창작자가 직접 연주하거나 녹음할 필요가 없습니다. 완성된 곡이 필요한 영상 및 숏드라마 배경음악, 버추얼 아티스트 데모, 음악 제작 배경이 없지만 감정이나 장면에 따라 빠르게 곡을 만들고 싶은 개발자에게 적합합니다.

핵심 특징

가사로 곡 구조를 직접 구성——가사는 [intro][verse][chorus][bridge][outro] 구조 태그를 지원하며, 단락별로 내용을 지정해 생성 곡의 단락 연결이 더 자연스러워집니다.
프롬프트로 스타일과 감정 제어——스타일 프롬프트로 장르·감정·편성을 묘사하면 모델이 이를 바탕으로 편곡과 보컬을 완성해 수동 파라미터 조정을 줄입니다.
출력 사양을 필요에 맞게 지정——mp3, wav, pcm 세 가지 형식을 선택할 수 있고 샘플링 레이트와 비트레이트를 지정해 이후 재생 또는 편집 파이프라인에 맞출 수 있습니다.

기능 설명

가사 기반 전체 곡 생성: 10-600자 가사와 10-300자 스타일 프롬프트를 제출하면 모델이 보컬과 반주가 포함된 곡을 한 번에 생성하며, 개발자는 바로 사용 가능한 오디오 파일을 얻을 수 있습니다.

구조 태그로 단락 구성: 가사에 [intro][verse][chorus] 등 태그로 단락을 나누어 절과 후렴의 위치 및 반복 관계를 명확히 하고 완성 곡의 형식적 일관성을 높입니다.

스타일과 감정의 텍스트 제어: 프롬프트로 장르·감정·악기 편성을 묘사해 다양한 소재의 배경음악 요구에 대응하며, 스타일마다 모델을 교체할 필요가 없습니다.

출력 오디오 파라미터 선택 가능: 요청에서 오디오 형식·샘플링 레이트·비트레이트를 지정해 다운스트림 플레이어나 후반 작업 요구에 맞는 사양으로 파일을 출력할 수 있습니다.

적용 시나리오

숏폼 영상 및 숏드라마 창작자의 배경음악 제작——줄거리 감정에 맞춰 프롬프트를 작성하고 가사를 첨부해 보컬이 포함된 주제가나 삽입곡을 생성, 영상 편집과 게시에 바로 사용할 수 있습니다.
버추얼 아티스트 운영사의 곡 데모——스타일 프롬프트와 가사로 완성된 보컬 곡을 빠르게 제작해 버추얼 가수의 작품이나 대외 홍보용 데모 소재로 활용합니다.
음악 배경 없는 창작자의 빠른 곡 제작——감정이나 장면 묘사와 직접 쓴 가사만 제공하면 편곡과 믹싱이 완료된 곡을 얻어 콘텐츠 게시나 행사에 사용할 수 있습니다.

제한 사항 및 모델 선택 가이드

사용자가 제공한 가사로만 곡을 생성할 수 있으며 자동 작사 기능은 제공하지 않습니다. 순수 기악 모드도 지원하지 않으므로 보컬 없는 배경음악이 필요하면 다른 모델을 선택해야 합니다. 가사는 최대 600자이며, 장 분량이 많거나 단락이 복잡한 구성은 간결하게 조정해야 합니다. 완성도는 프롬프트와 가사 품질에 좌우되므로 구조 태그로 단락을 나누는 것을 권장합니다. 고급 제어 기능이 더 필요하면 동일 시리즈의 상위 버전을 고려할 수 있습니다.

생성 작업 제출

POST https://api.hiapi.ai/v1/tasks

헤더

Authorizationstring필수

계정 API 키. 모든 요청에 필수입니다. 예: Bearer YOUR_HIAPI_API_KEY. API 키 받기

Content-Typestring선택

요청 본문은 항상 JSON으로 파싱됩니다. 전송 시 application/json(charset 포함 가능)만 허용되며, 다른 값은 415를 반환합니다. 예: application/json.

Idempotency-Keystring선택

멱등 키. 최대 255바이트. 같은 계정에서 같은 키의 재시도는 태스크를 한 번만 생성하며, 재전송 시 최초의 taskId를 반환합니다.

멱등 키

네트워크 타임아웃이나 클라이언트 자동 재시도 시 같은 키로는 태스크를 한 번만 생성하고 이중 과금되지 않습니다(범위 = API 키의 계정). 업무 고유 식별자(예: "order-42")를 키로 사용할 것을 권장합니다. 같은 키 재전송 시 최초 taskId를 반환하며, 키는 첫 제출 후 24시간 뒤 만료됩니다. 자세한 시나리오 표는 통합 비동기 API 소개 페이지를 참고하세요.

본문

modelstring필수

현재 고정 값: minimax-music-1.5

routestring선택

현재 고정 값: default

inputobject필수

minimax-music-1.5 및 루트 default의 비즈니스 파라미터 객체. 아래 파라미터 표를 참조하세요.

lyricsstring필수minLength 10maxLength 600

노래 가사로, 한 줄에 한 문장씩 작성합니다(\n으로 구분). 길이는 10-600자로 제한되며 구조 태그 [intro][verse][chorus][bridge][outro]를 지원합니다.

promptstring필수minLength 10maxLength 300

음악 스타일을 제어하는 텍스트 프롬프트로, 곡조, 분위기, 편성을 설명하는 데 사용됩니다. 길이는 10-300자로 제한됩니다.

bitrateinteger선택기본값: 256000

출력 오디오의 비트레이트로, 단위는 bps이며 기본값은 256000입니다.

옵션:3200064000128000256000

sample_rateinteger선택기본값: 44100

출력 오디오의 샘플레이트로, 단위는 Hz이며 기본값은 44100입니다.

옵션:16000240003200044100

audio_formatstring선택기본값: "mp3"

출력 오디오 형식이며 기본값은 mp3입니다.

옵션:mp3wavpcm

callbackobject선택

종료 상태 알림 설정. 생략하면 콜백이 전송되지 않으며 호출 측에서 폴링합니다.

콜백(Webhook)

생성 시 callback.url을 지정하면 태스크 종료 시 HiAPI가 서비스로 POST하여 폴링이 필요 없습니다. 콜백 본문은 태스크 상세와 동일한 구조입니다. 서명 검증·재시도·멱등에 대한 자세한 내용은 통합 비동기 API 소개 페이지의 콜백 설명을 참고하세요.

urlstring필수

callback 사용 시 필수. 태스크 종료 후 이 URL로 POST됩니다. 유효한 http(s) URL이어야 합니다.

whenstring선택기본값: "final"

현재는 final만 지원(success / fail 모두 알림).

옵션:final

storagestring선택기본값: "temp"

산출물 저장 등급: temp(기본·약 7일) 또는 persistent(장기 보관·용량 과금). 잔액 부족이나 저장 한도 초과 시 자동으로 temp로 강등됩니다. 실제 적용된 등급은 태스크 상세 응답에서 확인할 수 있습니다.

옵션:temppersistent

요청 예시

# 비동기 태스크 제출. 성공 시 즉시 taskId 반환(생성 완료 대기 없음)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-music-1.5",
  "input": {
    "lyrics": "…",
    "prompt": "…",
    "bitrate": 256000,
    "sample_rate": 44100,
    "audio_format": "mp3"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "minimax-music-1.5",
    input: {
      "lyrics": "…",
      "prompt": "…",
      "bitrate": 256000,
      "sample_rate": 44100,
      "audio_format": "mp3"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "minimax-music-1.5",
        "input": {
          "lyrics": "…",
          "prompt": "…",
          "bitrate": 256000,
          "sample_rate": 44100,
          "audio_format": "mp3"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

작업 상세 조회

GET https://api.hiapi.ai/v1/tasks/:id

응답 필드

taskIdstring필수

태스크 ID. 접두사는 항상 tk-hiapi-.

modelstring필수

확인된 전체 모델명. route 파라미터로 제출한 태스크는 base@route(예: gpt-image-2/text-to-image@ext)를 반환하며, 그 외에는 제출 시의 모델명과 동일합니다.

routestring선택

route 파라미터를 명시해 제출한 태스크에만 나타나며, 제출한 값을 그대로 반환합니다.

statusstring필수

태스크 상태.

상태 값

queued 대기 중, 아직 시작되지 않음. handling 처리 중. archiving 처리 완료, 산출물 준비 중. success 종료: 완료. 산출물 사용 가능(output 반환). fail 종료: 실패(error 반환). 제출 후 status로 판단합니다: success와 fail이 종료 상태이며 나머지는 비종료입니다. 1~3초 간격으로 종료까지 폴링하세요. 성공 시 output[].url에서 산출물을 다운로드하고 expireAt 전에 옮기세요. 장기 보관이 필요하면 생성 시 storage: "persistent"를 사용하세요.

creatednumber필수

태스크 생성 시각(Unix 초).

completednumber필수

종료 상태가 된 Unix 초. 비종료 상태에서는 0.

outputarray선택

status == success일 때만 나타납니다. 산출물 목록 — 항상 배열이며, 하나의 태스크에서 여러 type을 동시에 반환할 수 있습니다(예: video + first_frame).

Array [ object ]

배열 항목

urlstring필수

산출물 URL. 바로 다운로드할 수 있습니다.

typestring필수

현재 가능한 값: video, image, audio, first_frame, last_frame, thumbnail. 이후 확장될 수 있습니다.

expireAtnumber필수

산출물 접근 가능 기한(Unix 초). 만료 전에 다운로드하거나 이전하세요.

errorobject선택

status == fail일 때만 나타납니다.

codestring필수

비즈니스 오류 코드.

messagestring필수

오류 설명.

응답 예시

성공

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

처리 중(비종료)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

실패

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}