# Music Generation

> MiniMax Music generation source documentation.

Canonical URL: https://docs.uniall.ai/models/audio/music-generation
Locale: en

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:

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

Example:

```uri
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

```http
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

```json
{
  "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

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

queryExample:

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

Completed Response Example:

```json
{
  "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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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:

```json
{
  "model": "minimax-music-2.6",
  "lyrics": "Hello world"
}
```
`prompt`.

### 6.2 music

If:

```json
{
  "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

```bash
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}'
```