[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [MiniMax Music 1.5](https://spiral.ai/integrations/opencode/minimax-music-1-5)

# How to Use MiniMax Music 1.5 in opencode

MiniMax Music 1.5 turns lyrics and a musical brief into songs with vocals and layered accompaniment, up to four minutes long. Use sectioned lyrics to shape verses, choruses, and an ending.

|  |  |
| --- | --- |
| Model | MiniMax Music 1.5 |
| Available through | fal |
| Category | Audio |
| Price | $0.039 per generation. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with MiniMax Music 1.5 in opencode

- Read the game's story notes and use MiniMax Music 1.5 to create a vocal theme about the lighthouse keeper. Write original English lyrics under 600 characters with verse and chorus markers, describe a lonely folk mood separately, and save the audio in the game's assets.
- Use the product brief in this repository to write an original song for our demo video with MiniMax Music 1.5. Keep the lyrics under 600 characters, describe an optimistic pop style separately, and save the generated audio for the video editor.
- Read the short-film script and use MiniMax Music 1.5 to draft a closing song about the two characters meeting again. Use a reflective musical description and original verse, chorus, and outro lyrics totaling under 600 characters.
- Take the original chorus in lyrics.txt and use MiniMax Music 1.5 to explore two musical directions: gentle folk and energetic pop. Keep the sung words unchanged, check the 600-character limit, and save each result with a descriptive filename.
- Read the game's Chinese dialogue notes and use MiniMax Music 1.5 to create a Chinese vocal song about returning home. Write original lyrics under 600 characters with verse and chorus markers, describe a hopeful mood separately, and save the audio.

## How to set up MiniMax Music 1.5 in opencode

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run MiniMax Music 1.5**: One request; the result comes back by polling or a webhook.

```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/v1.5",
    "input": {
      "prompt": "[verse]\n 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…",
      "lyrics_prompt": "R&B, energetic"
    }
  }'
```

Then paste one of the prompts above: opencode finds MiniMax Music 1.5 on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## MiniMax Music 1.5 tools and prices

- [MiniMax (Hailuo AI) Music v1.5](https://spiral.ai/tools/fal/fal-ai/minimax-music/v1.5) (fal): $0.039 per generation.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| audio_setting |  | — | Audio configuration settings |

## What can you do with MiniMax Music 1.5 in opencode?

Create vocal songs for a game's story, a product video, or another project with MiniMax Music 1.5. A coding agent can turn project text into a compact lyric, generate the song, and place the audio alongside the project's assets.

### Songwriting demos

Try MiniMax Music 1.5 to hear how a short original lyric works as a sung verse and chorus. Use the result to choose a musical direction before developing the arrangement.

### Vocal themes for games

Create a song about a game character, place, or quest with MiniMax Music 1.5. Write a compact lyric and describe the scene's mood separately.

### Songs for short films

Use MiniMax Music 1.5 to explore an original vocal song for a closing scene or montage. Give the song a clear emotional brief and lyrics tied to the story.

### Short-video music

Draft a sung refrain for a travel diary, cooking video, or personal project with MiniMax Music 1.5. Select an excerpt from the generated song during editing.

### Personal occasion songs

Turn a few original lines about a birthday, graduation, or reunion into a song with MiniMax Music 1.5. Keep the lyric focused on a small number of specific memories.

### English and Chinese lyric demos

Create separate English and Chinese song demos with MiniMax Music 1.5. Adapt each lyric to fit the 600-character limit and review the performances separately.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## MiniMax Music 1.5 in other agents

- [Amp](https://spiral.ai/integrations/amp/minimax-music-1-5)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/minimax-music-1-5)
- [Claude](https://spiral.ai/integrations/claude-desktop/minimax-music-1-5)
- [Claude Code](https://spiral.ai/integrations/claude-code/minimax-music-1-5)
- [Cline](https://spiral.ai/integrations/cline/minimax-music-1-5)
- [Codex](https://spiral.ai/integrations/codex/minimax-music-1-5)
- [Cursor](https://spiral.ai/integrations/cursor/minimax-music-1-5)
- [Devin](https://spiral.ai/integrations/devin/minimax-music-1-5)
- [dots](https://spiral.ai/integrations/dots/minimax-music-1-5)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/minimax-music-1-5)
- [Gemini](https://spiral.ai/integrations/gemini/minimax-music-1-5)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/minimax-music-1-5)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/minimax-music-1-5)
- [goose](https://spiral.ai/integrations/goose/minimax-music-1-5)
- [Grok](https://spiral.ai/integrations/grok/minimax-music-1-5)
- [Grok Build](https://spiral.ai/integrations/grok-build/minimax-music-1-5)
- [Hermes](https://spiral.ai/integrations/hermes/minimax-music-1-5)
- [Instinct](https://spiral.ai/integrations/instinct/minimax-music-1-5)
- [Manus](https://spiral.ai/integrations/manus/minimax-music-1-5)
- [Muse](https://spiral.ai/integrations/muse/minimax-music-1-5)
- [Muse Code](https://spiral.ai/integrations/muse-code/minimax-music-1-5)
- [n8n](https://spiral.ai/integrations/n8n/minimax-music-1-5)
- [Notion](https://spiral.ai/integrations/notion/minimax-music-1-5)
- [OpenClaw](https://spiral.ai/integrations/openclaw/minimax-music-1-5)
- [Perplexity](https://spiral.ai/integrations/perplexity/minimax-music-1-5)
- [Raycast](https://spiral.ai/integrations/raycast/minimax-music-1-5)
- [VS Code](https://spiral.ai/integrations/vscode/minimax-music-1-5)
- [Windsurf](https://spiral.ai/integrations/windsurf/minimax-music-1-5)
- [Zapier](https://spiral.ai/integrations/zapier/minimax-music-1-5)

## More opencode guides

- [MiniMax Music 01](https://spiral.ai/integrations/opencode/minimax-music-01)
- [MiniMax Music 2.0](https://spiral.ai/integrations/opencode/minimax-music-2-0)
- [MMAudio V2 Text to Audio](https://spiral.ai/integrations/opencode/mmaudio-v2-text-to-audio)
- [MiniMax Music 2.5](https://spiral.ai/integrations/opencode/minimax-music-2-5)
- [Lyria 3.5](https://spiral.ai/integrations/opencode/lyria-3-5)
- [MiniMax Music 2.6](https://spiral.ai/integrations/opencode/minimax-music-2-6)

## Questions about MiniMax Music 1.5 in opencode

**Can opencode use MiniMax Music 1.5?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run MiniMax Music 1.5 like any built-in tool.

**How much does MiniMax Music 1.5 cost in opencode?**

$0.039 per generation. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need a fal account to use MiniMax Music 1.5 in opencode?**

No. Spiral runs MiniMax Music 1.5 on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up MiniMax Music 1.5 in opencode?**

About two minutes: add the server, then sign in, then check it.

**Does opencode wait while MiniMax Music 1.5 runs?**

MiniMax Music 1.5 runs in the background. opencode starts the run, checks on it and gives you the audio when it's ready.

**What is MiniMax Music 1.5 good at?**

It creates songs with vocals and instrumental accompaniment from lyrics and a musical description. Consider it for songwriting demos, vocal themes for games, and songs for short videos.

**How long can a MiniMax Music 1.5 song be?**

The documented maximum is four minutes. Treat that as a ceiling when planning a song, rather than a target every result must reach.

**How should I structure the lyrics?**

Separate sung lines with line breaks and mark sections with [intro], [verse], [chorus], [bridge], and [outro]. Keep the complete lyric submission within 10 to 600 characters.

**What should I put in the musical description?**

Describe the style, mood, and intended scene separately from the lyrics. For example, try a gentle folk song for a rainy train ride, then provide only the words you want sung in the lyrics.

**Which lyric languages are documented?**

The Music 1.5 model card documents English and Chinese lyrics. Use those languages when you need a documented starting point.

