VOD APILast Updated 2026-09-05 19:41:37

MiniMax Music

On this page

Endpoint: POST https://vod.intl.tencentcloudapi.com
Action: 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)

요청 예시

LANGUAGE
{
  "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}"
}

응답 예시

LANGUAGE
{
  "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에는 곡의 분위기와 스타일을 적습니다.

LANGUAGE
{
  "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로 지정합니다.

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

출력 포맷

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

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

추가 옵션

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