MiniMax Music

Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcAudioTask

기본 정보

항목	값
ModelName	MiniMaxMusic
ModelVersion	3.0 / 2.6 / 2.5 / 2.0
SceneType	music
출력 비트레이트	생성 파일의 메타데이터에서 확인
출력 길이	모델과 요청 옵션에 따라 달라지며 결과 메타데이터에서 확인
출력 스펙	MP3, 44.1kHz 스테레오
작업 완료	조회 API의 완료 상태로 확인

가사를 직접 넣을 수 있습니다.

요청 파라미터

파라미터	필수	타입	설명
ModelName	필수	String	고정값 MiniMaxMusic
ModelVersion	선택	String	3.0 / 2.6 / 2.5 / 2.0
SceneType	필수	String	music
Prompt	필수	String	곡 분위기와 스타일 프롬프트
AdditionalParameters	선택	String	lyrics(가사), instrumental(보컬 제거 여부, Boolean)

요청 예시

{
  "SubAppId": 123456789,
  "ModelName": "MiniMaxMusic",
  "ModelVersion": "2.6",
  "SceneType": "music",
  "Prompt": "a cheerful pop song, upbeat tempo",
  "AdditionalParameters": "{\"lyrics\": \"Sunlight on the windowsill, a new day has begun\"}"
}

{
  "SubAppId": 123456789,
  "ModelName": "MiniMaxMusic",
  "ModelVersion": "3.0",
  "SceneType": "music",
  "Prompt": "lo-fi hip hop beat for study background",
  "AdditionalParameters": "{\"instrumental\": true}"
}

응답 예시

{
  "AigcAudioTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Output": {
      "AudioInfos": [
        {
          "FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcAudioGenFile.mp3"
        }
      ]
    }
  }
}

모델 전용 오디오 옵션

모델	필드	설명
MiniMaxMusic	lyrics	가사
MiniMaxMusic	instrumental	보컬 제거 여부. Boolean
MiniMaxMusic	sample_rate / bitrate	출력 오디오 스펙

특수 설정

버전 선택

ModelVersion	특징
3.0	3.0 계열
2.6	2.6 계열
2.5	이전 버전
2.0	초기 버전

가사 지정 (lyrics)

가사는 AdditionalParameters의 lyrics 필드로 전달합니다. Prompt에는 곡의 분위기와 스타일을 적습니다.

{
  "SubAppId": 123456789,
  "ModelName": "MiniMaxMusic",
  "ModelVersion": "3.0",
  "SceneType": "music",
  "Prompt": "a bright and cheerful pop song",
  "AdditionalParameters": "{\"lyrics\": \"Sunlight on the windowsill, a new day has begun\"}",
  "OutputConfig": {
    "StorageMode": "Temporary",
    "OutputAudioFormat": "mp3"
  }
}

AdditionalParameters

필드	타입	설명
lyrics	String	가사
instrumental	Boolean	보컬 제거. 반주만 생성
sample_rate	Integer	출력 샘플레이트
bitrate	Integer	출력 비트레이트

출력 비트레이트는 32 kbps로 고정됩니다

MiniMaxMusic은 32 kbps MP3를 출력합니다. 192 kbps 출력은 GL을 사용하세요.

연주곡 생성

instrumental을 true로 지정합니다.

{
  "SubAppId": 123456789,
  "ModelName": "MiniMaxMusic",
  "ModelVersion": "3.0",
  "SceneType": "music",
  "Prompt": "lo-fi hip hop beat for study background",
  "AdditionalParameters": "{\"instrumental\": true}"
}

출력 포맷

OutputConfig.OutputAudioFormat으로 결과 파일 형식을 지정합니다.

{
  "OutputConfig": {
    "StorageMode": "Temporary",
    "OutputAudioFormat": "mp3"
  }
}

추가 옵션

VOD의 보컬 제어는 instrumental, MPS는 is_instrumental Boolean 값을 사용합니다. MiniMaxMusic의 출력은 32 kbps MP3입니다.