# MiniMax (Hailuo AI) Music

Turn text into speech and audio with MiniMax (Hailuo AI) Music from fal through one Spiral API key. It runs in the background and returns audio. Pay as you go, with no subscription.

- Provider: fal
- Category: Audio
- Runs: In the background
- Returns: audio
- Tool id: `fal` / `fal-ai/minimax-music`
- Page: https://spiral.ai/tools/fal/fal-ai/minimax-music

## Pricing

$0.0455 per generation.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 30 minutes
- Longest run, end to end: 255 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `prompt` (required) | text |  | — | Lyrics with optional formatting. You can use a newline to separate each line of lyrics. You can use two newlines to add a pause between lines. You can use double hash marks (##) at the beginning and end of the lyrics to add accompaniment. Maximum 600 characters. |
| `reference_audio_url` (required) | text |  | — | Reference song, should contain music and vocals. Must be a .wav or .mp3 file longer than 15 seconds. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/minimax-music",
    "input": {
      "prompt": "## Fast and Limitless   \n In the heart of the code, where dreams collide,   \n\nFAL'\''s the name, taking tech for a ride.    \nGenerative media, blazing the trail,  …",
      "reference_audio_url": "https://fal.media/files/lion/OOTBTSlxKMH_E8H6hoSlb.mpga"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=fal-ai%2Fminimax-music

## Common questions

### MiniMax (Hailuo AI) Music

**How much does MiniMax (Hailuo AI) Music cost?**

$0.0455 per generation. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use MiniMax (Hailuo AI) Music through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/minimax-music"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use MiniMax (Hailuo AI) Music?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use MiniMax (Hailuo AI) Music?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

