[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [MiniMax Music 2.5](https://spiral.ai/integrations/gemini-cli/minimax-music-2-5)

# How to Use MiniMax Music 2.5 in Gemini CLI

MiniMax Music 2.5 turns lyrics and a style description into complete songs with singing and accompaniment. Its section tags let you shape verses, choruses, instrumental breaks, and changes in vocal delivery.

|  |  |
| --- | --- |
| Model | MiniMax Music 2.5 |
| Available through | fal |
| Category | Audio |
| Price | $0.195 per run at the default inputs. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with MiniMax Music 2.5 in Gemini CLI

- Read the game's character notes and use MiniMax Music 2.5 to create an English character song. Write original [Verse], [Chorus], and [Bridge] sections, with restrained piano verses and a determined chorus supported by strings.
- Use the product brief in this project to write an original launch song with MiniMax Music 2.5. Aim for upbeat funk-pop, warm lead vocals, rhythmic guitar, and a chorus about the product's main benefit without inventing claims.
- Read the screenplay's final scene and create an end-credit song with MiniMax Music 2.5. Use reflective indie folk, fingerpicked guitar, intimate verses, a fuller final chorus, and an [Outro].
- Turn the English learning rhyme in this project's lesson content into a song with MiniMax Music 2.5. Preserve its teaching points, organize it into verses and a repeating chorus, and request clear singing with light piano accompaniment.
- Use the original lyrics in this project to make two song demos with MiniMax Music 2.5: one vocal jazz arrangement with brushed drums and upright bass, and one acoustic folk arrangement. Keep the words and section order the same.

## How to set up MiniMax Music 2.5 in Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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 2.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/v2.5",
    "input": {
      "prompt": "Indie folk, melancholic, introspective, longing, solitary walk, coffee shop"
    }
  }'
```

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## MiniMax Music 2.5 tools and prices

- [Minimax Music 2.5](https://spiral.ai/tools/fal/fal-ai/minimax-music/v2.5) (fal): $0.195 per run at the default inputs.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| lyrics |  |  | Lyrics of the song. Use \n to separate lines. Supports structure tags: [Intro], [Verse], [Pre Chorus], [Chorus], [Bridge], [Outro], [Interlude], [Hook], [Break], [Solo], [Inst]. Max 3500 characters. Required when is_instrumental is false and lyrics_optimizer is false. |
| is_instrumental |  | false | When true, generates vocal-free instrumental music. |
| lyrics_optimizer |  | false | When true and lyrics is empty, auto-generates lyrics from the prompt. |
| audio_setting |  | — | Audio configuration settings |

## What can you do with MiniMax Music 2.5 in Gemini CLI?

Create sung themes and song demos from the project's story, characters, or product brief. Use the files to draft original lyrics and give MiniMax Music 2.5 clear section and performance directions.

### Songwriting demos

Turn original lyrics into a sung demo to hear how the verses, chorus, and bridge work together.

### Brand song concepts

Try an original brand chorus with a clear genre, mood, and vocal direction before choosing a musical direction.

### Film end-credit songs

Create a lyrical song that follows a story's emotional arc, moving from restrained verses to a fuller closing chorus.

### Game character themes

Write a sung theme around a character's motives and story, with contrasting sections for doubt and resolve.

### Podcast theme songs

Develop an original sung theme around a show's premise, then select an excerpt during editing.

### Educational songs

Set an original English or Mandarin lesson rhyme to music, using a repeating chorus for the central idea.

### Personal celebration songs

Turn a birthday, reunion, or farewell story into verses and a chorus with a fitting vocal style.

### Arrangement experiments

Explore how the same original lyrics feel with different instrumentation, moods, and section-level performance directions.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## MiniMax Music 2.5 in other agents

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

## More Gemini CLI guides

- [MiniMax Music 2.0](https://spiral.ai/integrations/gemini-cli/minimax-music-2-0)
- [MiniMax Music 2.6](https://spiral.ai/integrations/gemini-cli/minimax-music-2-6)
- [MiniMax Music 1.5](https://spiral.ai/integrations/gemini-cli/minimax-music-1-5)
- [MiniMax Music 3](https://spiral.ai/integrations/gemini-cli/minimax-music-3)
- [MiniMax Music 01](https://spiral.ai/integrations/gemini-cli/minimax-music-01)
- [MiniMax Speech 2.5 HD](https://spiral.ai/integrations/gemini-cli/minimax-speech-2-5-hd)

## Questions about MiniMax Music 2.5 in Gemini CLI

**Can Gemini CLI use MiniMax Music 2.5?**

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

**How much does MiniMax Music 2.5 cost in Gemini CLI?**

$0.195 per run at the default inputs. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

**Do I need a fal account to use MiniMax Music 2.5 in Gemini CLI?**

No. Spiral runs MiniMax Music 2.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 2.5 in Gemini CLI?**

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

**Does Gemini CLI wait while MiniMax Music 2.5 runs?**

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

**What does MiniMax Music 2.5 create?**

It creates complete songs with singing, accompaniment, and arrangements from lyrics and a description of the sound you want.

**How long can a song be?**

The published maximum is approximately five minutes per generation. Treat that as an upper limit when planning a song.

**Which languages work best?**

English and Mandarin Chinese have the strongest support. Other languages can work, but pronunciation is less consistent, so review the singing before using it.

**How do I control the song's arrangement?**

Mark the lyrics with section tags such as [Verse], [Chorus], [Bridge], and [Outro]. Add instrument names and performance directions where the arrangement or singing should change.

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

Specify genre, mood, and the scene or use the song should suit. For example, describe reflective indie folk for a farewell scene instead of asking for a good song.

