# MiniMax Music 3

> MiniMax Music 3 via Fal.AI. Generates complete songs with vocals up to five minutes long from a music description (genre, mood, BPM, key, vocals, arrangement) and structured lyrics ([verse], [chorus], [bridge], ...). Returns 44.1 kHz stereo WAV.

- **Provider**: fal
- **Model ID**: minimax/music-3
- **Category**: music_generation
- **Credits**: 280 per request
- **Pricing Type**: formula

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `duration` (number, optional): Upper bound on the generated audio length in seconds (max 300). Billed per second of this requested bound — the model may stop earlier; the actual duration is returned in the output. (Default: `60`; Range: min: 1, max: 300)
- `seed` (integer, optional): Random seed for reproducibility. A random seed is used when omitted.
- `prompt` (string, **required**): Music description: style, mood, vocals, instrumentation and arrangement. For precise control use a structured caption with global metadata (genre, BPM, key, emotional progression), vocal details, and a section-by-section arrangement.
- `lyrics` (string, **required**): The lyrics to sing. Structure tags such as [intro], [verse], [pre-chorus], [chorus], [post-chorus], [bridge], [instrumental], [solo] and [outro] must each be on their own line; text on the same line as a leading tag is dropped.
- `guidance_scale` (number, optional): Classifier-free guidance scale of the flow-matching stage. (Default: `1.7`; Range: min: 0, max: 20)
- `num_inference_steps` (integer, optional): Number of flow-matching steps per 8-second denoising chunk. More steps improve quality at the cost of speed. (Default: `30`; Range: min: 1, max: 100)

## Example Request

```json
{
  "model": "minimax/music-3",
  "input": {
    "duration": 60,
    "prompt": "Genre: acoustic pop. BPM: 96. Key: C major. Warm and intimate, building gently into the chorus. Vocals: soft female lead, close and breathy, light stacked harmonies in the chorus. Arrangement: fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.",
    "lyrics": "[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

json

## Tags

music-generation, text-to-music, minimax, lyrics

## Documentation

https://fal.ai/models/minimax/music-3