음악 및 커버 생성

MiniMax 음악 프로토콜로 음악 또는 커버 결과를 동기 생성합니다.

이 인터페이스는 하나의 동기 HTTP 요청에서 음악 또는 커버 결과를 생성합니다. 일반 요청은 임시 오디오 URL 또는 Hex 오디오 내용을 반환할 수 있으며 스트리밍 요청은 JSON 오디오 청크를 한 줄씩 반환합니다.

스트리밍 결과는 수신 순서대로 data.audio의 Hex 내용을 이어 붙이고 data.status=2를 받은 후 디코딩과 저장을 완료해야 합니다. HTTP 상태가 200이어도 base_resp.status_code를 확인해야 하며 값이 0일 때만 업무 성공을 의미합니다.

POST/v1/music_generation

음악 또는 커버 결과를 동기 생성합니다. stream=true이면 동일한 HTTP 연결에서 JSON 오디오 청크를 한 줄씩 반환하며 비동기 작업은 생성하지 않습니다.

스트리밍 결과의 data.audio는 Hex 오디오 조각이며 수신 순서대로 이어 붙여야 합니다. data.status=2는 생성 완료를 의미합니다.

스트리밍 응답은 항상 Hex 오디오 청크를 반환합니다. stream=true일 때 output_format=url을 전달해도 현재 게이트웨이가 이 값을 무시하고 Hex 스트림을 반환할 수 있습니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

application/json

음악 또는 커버 생성 매개변수입니다. 필드의 조건부 필수 여부는 생성 모드에 따라 달라집니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

model*string

현재 API 키에 표시되는 MiniMax 음악 모델 ID입니다. 예: music-3.0, music-2.6 또는 music-cover.

prompt?string

스타일, 감정 및 상황 설명입니다. 연주곡 모드에서는 필수이며 그 외 모드에서는 생략할 수 있습니다.

길이length <= 2000

lyrics?string

줄바꿈으로 구분한 가사입니다. 연주곡이 아닌 경우 일반적으로 필수입니다. 가사 최적화를 활성화하고 비워 두면 자동으로 생성할 수 있습니다.

길이length <= 3500

stream?boolean

현재 HTTP 응답에서 JSON Hex 오디오 청크를 한 줄씩 반환할지 여부입니다.

기본값false

output_format?string

오디오 반환 방식입니다. 스트리밍 응답은 항상 hex이며 url을 전달해도 현재 게이트웨이가 이 값을 무시하고 Hex 청크를 반환할 수 있습니다. URL은 일반적으로 24시간 후 만료됩니다.

기본값"hex"

허용 값

"url"
"hex"

audio_setting?

lyrics_optimizer?boolean

가사가 비어 있을 때 Prompt를 기준으로 가사를 자동 생성할지 여부입니다.

기본값false

is_instrumental?boolean

보컬 없는 연주곡을 생성할지 여부입니다. true이면 lyrics가 필요하지 않습니다.

기본값false

audio_url?string

커버 참조 오디오 URL이며 audio_base64, cover_feature_id와 함께 사용할 수 없습니다.

형식uri

audio_base64?string

커버 참조 오디오 Base64이며 audio_url, cover_feature_id와 함께 사용할 수 없습니다.

cover_feature_id?string

커버 전처리에서 반환된 특징 ID이며 유효 기간은 24시간입니다. 사용할 때 10~1000자의 가사를 제공해야 합니다.

aigc_watermark?boolean

오디오 끝에 AIGC 워터마크를 추가할지 여부이며 비스트리밍 요청에서만 적용됩니다.

기본값false

응답 본문

`application/json`

curl -X POST "https://example.com/v1/music_generation" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "부드러운 피아노와 현악기, 아침 일출, 따뜻하고 치유적인 분위기, 영화 음악 스타일",
    "is_instrumental": true,
    "audio_setting": {
      "sample_rate": 44100,
      "bitrate": 256000,
      "format": "mp3"
    },
    "output_format": "url",
    "stream": false
  }'

{
  "data": {
    "audio": "https://example.com/music/output.mp3",
    "status": 2
  },
  "trace_id": "04ede0ab069fb1ba8be5156a24b1e081",
  "extra_info": {
    "music_duration": 244262,
    "music_sample_rate": 44100,
    "music_channel": 2,
    "bitrate": 256000,
    "music_size": 7818388
  },
  "analysis_info": null,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

인증

요청 본문

응답 본문

200application/json

401application/json

`application/json`

`application/json`