MPS APILast Updated 2026-09-30

MiniMax Music

On this page

Endpoint: POST https://mps.intl.tencentcloudapi.com
Action: CreateAigcAudioTask

기본 정보

항목	값
ModelName	`MiniMaxMusic`
ModelVersion	`3.0` / `2.6` / `2.5` / `2.0`
SceneType	`music`

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

요청 파라미터

파라미터	필수	타입	설명
`ModelName`	필수	String	고정값 `MiniMaxMusic`
`ModelVersion`	선택	String	`3.0` / `2.6` / `2.5` / `2.0`
`SceneType`	필수	String	`music`
`Prompt`	필수	String	곡 분위기와 스타일 프롬프트
`Duration`	선택	Integer	길이(초). `0~60`
`OutputAudioFormat`	선택	String	`mp3` 또는 `wav`
`AdditionalParameters`	선택	String	`lyric`(가사), `is_instrumental`(보컬 제거 여부, Boolean)

가사는 AdditionalParameters.lyric에 넣고 줄바꿈은 \n으로 구분합니다. 연주곡은 is_instrumental=true로 지정합니다.

VOD 경로의 CreateAigcAudioTask는 같은 MiniMaxMusic라도 가사 필드 이름이 lyrics(복수)이고 보컬 제거 필드가 instrumental입니다. MPS는 lyric(단수)와 is_instrumental입니다. 두 경로를 함께 쓰는 코드라면 필드명을 분기하세요.

요청 예시

LANGUAGE
{
  "ModelName": "MiniMaxMusic",
  "ModelVersion": "2.6",
  "SceneType": "music",
  "Prompt": "an upbeat pop track with a bright melody",
  "AdditionalParameters": "{\"lyric\":\"Sunlight on the windowsill\\nA new day has begun\\nThe breeze carries flowers in\"}",
  "OutputAudioFormat": "mp3"
}
{
  "ModelName": "MiniMaxMusic",
  "ModelVersion": "3.0",
  "SceneType": "music",
  "Prompt": "lo-fi hip hop beat for study background",
  "AdditionalParameters": "{\"is_instrumental\":true}",
  "OutputAudioFormat": "mp3"
}

응답 예시

LANGUAGE
{
  "Response": {
    "Status": "DONE",
    "Message": "ok",
    "AudioInfos": [
      {
        "Url": "https://aigc-output-audio-file-<id>.cos.<region>.myqcloud.com/<file>.mp3?q-sign-algorithm=sha1&..."
      }
    ],
    "VideoInfos": [],
    "RequestId": "<request-id>"
  }
}