Music Generation

This document explains how to use MiniMax Music 2.6 async music generation endpoint.

Supported models:

Model name	Type	Suitable scenarios	Billing mode
minimax-music-2.6	music generation	ad music, short-video background music, podcast intro, product promo track, instrumental ambience bed	billed by output audio item count

Endpoint async task mode:

Operation	Method	Path
submit musictask	POST	/v1/audio/tasks
query musictask	GET	/v1/audio/tasks/{task_id}

---

1. Authentication

Endpoint requires request headers API Key:

Authorization: Bearer sk-xxxxxxxxxxxxxxxx
Content-Type: application/json

Example:

https://api.xxx.xx

---

2. Model overview

minimax-music-2.6 music description and generate music audio. generation video, pass, music, BGM.

Modelsupports:

• pass prompt+lyrics
• music: pass prompt+is_instrumental: true

---

3. submit musictask

POST https://api.xxx.xx/v1/audio/tasks

3.1 Request Parameters

Parameters	Type	Required	Note
model	string	Yes	minimax-music-2.6
prompt	string	Yes	music description, recommended style, Purpose,
lyrics	string	No	. music recommendedprovides
lyrics_optimizer	boolean	No	Whether
is_instrumental	boolean	No	Whether to generate music
audio_setting	object	No	audio object, the platformavailableCapabilitypass through

3.2 submitResponse Examples

{
  "id": "task_xxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxx",
  "object": "audio.generation.job",
  "status": "queued"
}

Field Reference:

Field	Note
id/task_id	async task ID, query result
status	task status, value queued, processing, completed, failed

---

4. query musictask

GET https://api.xxx.xx/v1/audio/tasks/{task_id}

queryExample:

curl -X GET "https://api.xxx.xx/v1/audio/tasks/task_xxxxxxxxxxxxx" \
 -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx"

Completed Response Example:

{
  "id": "task_xxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxx",
  "object": "audio.generation.job",
  "status": "completed",
  "audio_url": "https://api.xxx.xx/media/xxxxx.mp3",
  "result": {
    "outputs": [
      "https://api.xxx.xx/media/xxxxx.mp3"
    ],
    "audios": [
      {
        "url": "https://api.xxx.xx/media/xxxxx.mp3"
      }
    ]
  }
}

---

5. Request Examples

5.1 generation

curl -X POST "https://api.xxx.xx/v1/audio/tasks" \
 -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
 -H "Content-Type: application/json" \
 -d '{"model": "minimax-music-2.6",
 "prompt": "A bright synth pop song for a product launch, upbeat, modern commercial style, clean vocal, energetic chorus",
 "lyrics": "Hello future, we are ready now\nLight the skyline, make it loud\nEvery step is shining brighter\nWe are here and moving proud",
 "lyrics_optimizer": true,
 "is_instrumental": false}'

5.2 generationshort-video background music

curl -X POST "https://api.xxx.xx/v1/audio/tasks" \
 -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
 -H "Content-Type: application/json" \
 -d '{"model": "minimax-music-2.6",
 "prompt": "A catchy 30-second lifestyle vlog background track, light guitar, soft beat, sunny mood, no vocal",
 "is_instrumental": true}'

5.3 generation music

curl -X POST "https://api.xxx.xx/v1/audio/tasks" \
 -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
 -H "Content-Type: application/json" \
 -d '{"model": "minimax-music-2.6",
 "prompt": "A warm podcast intro jingle, 8 to 12 seconds feeling, soft piano, subtle electronic pulse, professional and friendly",
 "is_instrumental": true}'

5.4 generationChinese

curl -X POST "https://api.xxx.xx/v1/audio/tasks" \
 -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
 -H "Content-Type: application/json" \
 -d '{"model": "minimax-music-2.6",
 "prompt": "Chinese mandopop brand song, warm female vocal, inspiring chorus, clean arrangement, suitable for a technology brand",
 "lyrics": " \nnew \n \n to change ",
 "lyrics_optimizer": true,
 "is_instrumental": false}'

5.5 generation music

curl -X POST "https://api.xxx.xx/v1/audio/tasks" \
 -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
 -H "Content-Type: application/json" \
 -d '{"model": "minimax-music-2.6",
 "prompt": "Educational course intro music, calm but motivating, soft marimba, piano, gentle percussion, suitable for online learning",
 "is_instrumental": true}'

---

6. Common Errors

6.1 prompt

Error:

{
  "model": "minimax-music-2.6",
  "lyrics": "Hello world"
}

prompt.

6.2 music

If:

{
  "is_instrumental": false
}

recommended to pass both lyrics.

---

7. recommended

1. scenario music style, Purpose.
2. If required, provides.
3. submit /v1/audio/tasks.
4. poll /v1/audio/tasks/{task_id}.
5. task completed read audio_url.

---

8. Minimum Valid Request

curl -X POST "https://api.xxx.xx/v1/audio/tasks" \
 -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
 -H "Content-Type: application/json" \
 -d '{"model": "minimax-music-2.6",
 "prompt": "A bright short commercial pop song, modern and uplifting",
 "is_instrumental": true}'