---
url: /orchestration/reference/operations/InvokeMiniMaxMusic3StepTemplate.md
description: 'POST /v2/consumer/recipes/miniMaxMusic3 — Generate a complete song from a structured caption and lyrics with MiniMax Music 3'
---

> Documentation index: https://developer.civitai.com/llms.txt — every page on this site has a markdown version at its URL + `.md`.

# Generate a complete song from a structured caption and lyrics with MiniMax Music 3

`POST https://orchestration.civitai.com/v2/consumer/recipes/miniMaxMusic3`

Operation `InvokeMiniMaxMusic3StepTemplate` · Recipes · Civitai Orchestration API, generated from the published OpenAPI spec ([v2-consumers.json](https://developer.civitai.com/openapi/v2-consumers.json)); the interactive HTML page is this URL without `.md`.

## Authentication

Send `Authorization: Bearer <token>` (the spec's `ApiKey` scheme); this operation documents `401 Unauthorized` for a missing or invalid token. See [Authentication](https://developer.civitai.com/orchestration/guide/authentication.md).

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `experimental` | query | boolean | no |  |
| `allowMatureContent` | query | boolean | no |  |
| `whatif` | query | boolean | no |  |
| `ephemeral` | query | boolean | no |  |
| `tier` | query | `WorkflowTier` (one of `paid`, `free`) | no | How a workflow is paid for. |

## Request body

Optional. Content types: `application/json`, `text/json`, `application/*+json`.

Schema `MiniMaxMusic3Input`.

| Field | Type | Required | Description |
|---|---|---|---|
| `prompt` | string | yes | What the track should sound like, as a structured description. For best results use Global Metadata, Vocal Details, and Arrangement sections. The words to sing go in lyrics. |
| `lyrics` | string | yes | Lyrics with section markers such as [Intro], [Verse], [Chorus], and [Outro]. |
| `seed` | integer (int32) | yes |  |
| `maxDuration` | number (float) | no | Maximum generated song duration in seconds. The model may end the song earlier when the requested lyric structure is complete. (default `120`, minimum `0.03999999910593033`, maximum `360`) |
| `steps` | integer (int32) | no | (default `30`, minimum `1`, maximum `100`) |
| `cfgScale` | number (float) | no | Classifier-free guidance scale used by both text encoding and sampling. (default `1.7`, minimum `0`, maximum `100`) |
| `topK` | integer (int32) | no | Top-k sampling limit used by the MiniMax music text encoder. (default `50`, minimum `1`, maximum `16384`) |
| `diffusionModel` | string, nullable | no | (pattern `^(?:urn:)?(?:air:)?(?:(?<ecosystem>[a-zA-Z0-9_\-\/]+):)?(?:(?<type>[a-zA-Z0-9_\-\/]+):)?(?<source>[a-zA-Z0-9_\-\/]+):(?<id>[a-zA-Z0-9_\-\/\.]+)(?:@(?<version>[a-zA-Z0-9_\-\/.=,%+:]+))?(?:\.(?<format>[a-zA-Z0-9_\-]+))?$`) |
| `textEncoder` | string, nullable | no | (pattern `^(?:urn:)?(?:air:)?(?:(?<ecosystem>[a-zA-Z0-9_\-\/]+):)?(?:(?<type>[a-zA-Z0-9_\-\/]+):)?(?<source>[a-zA-Z0-9_\-\/]+):(?<id>[a-zA-Z0-9_\-\/\.]+)(?:@(?<version>[a-zA-Z0-9_\-\/.=,%+:]+))?(?:\.(?<format>[a-zA-Z0-9_\-]+))?$`) |
| `vae` | string, nullable | no | (pattern `^(?:urn:)?(?:air:)?(?:(?<ecosystem>[a-zA-Z0-9_\-\/]+):)?(?:(?<type>[a-zA-Z0-9_\-\/]+):)?(?<source>[a-zA-Z0-9_\-\/]+):(?<id>[a-zA-Z0-9_\-\/\.]+)(?:@(?<version>[a-zA-Z0-9_\-\/.=,%+:]+))?(?:\.(?<format>[a-zA-Z0-9_\-]+))?$`) |
| `loras` | map of number (double) | no | Optional LoRAs to apply to both the diffusion model and MiniMax text encoder. Compatibility with the selected base resources is the caller's responsibility. |

## Responses

### 200 OK

Content type: `application/json`.

Schema `MiniMaxMusic3Output`.

| Field | Type | Required | Description |
|---|---|---|---|
| `blob` | `AudioBlob` | yes |  |

### 400 Bad Request

Content type: `application/json`.

Schema `ProblemDetails`.

| Field | Type | Required | Description |
|---|---|---|---|
| `type` | string, nullable | no |  |
| `title` | string, nullable | no |  |
| `status` | integer (int32), nullable | no |  |
| `detail` | string, nullable | no |  |
| `instance` | string, nullable | no |  |

### 401 Unauthorized

Content type: `application/json`.

Schema `ProblemDetails` — fields as listed above.

### 403 Forbidden

Content type: `application/json`.

Schema `ProblemDetails` — fields as listed above.