[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [ElevenLabs Music](https://spiral.ai/integrations/gemini-cli/elevenlabs-music)

# How to Use ElevenLabs Music in Gemini CLI

ElevenLabs Music turns a written brief into songs with vocals or instrumental scores for videos, podcasts, and games. Use a text prompt to explore a direction, or a composition plan to guide sections and lyric placement.

|  |  |
| --- | --- |
| Model | ElevenLabs Music |
| Available through | ElevenLabs |
| Category | Audio |
| Price | $0.195 per minute of music. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with ElevenLabs Music in Gemini CLI

- Read the game's scene descriptions and use ElevenLabs Music to create a 60-second instrumental exploration cue: calm ambient electronic music, soft synthesizers, sparse piano, and 70 BPM.
- Use the demo script in this project to brief ElevenLabs Music on a 90-second instrumental background: understated electronic music, warm bass, light percussion, and 100 BPM.
- Read the trailer outline and use ElevenLabs Music to generate a 45-second orchestral score with a composition plan: 15 seconds of tension, 20 seconds of building strings and brass, then a 10-second resolution.
- Use the original lyrics in this project's song draft with ElevenLabs Music to make a two-minute acoustic folk demo. Keep the verse and chorus order, with fingerpicked guitar and an intimate lead vocal.
- Use ElevenLabs Music to create three separate 15-second instrumental title cues for this game's menu: one solo piano, one acoustic guitar, and one soft synthesizer. Keep each calm and slow.

## How to set up ElevenLabs Music 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 ElevenLabs Music**: 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": "elevenlabs",
    "model": "music",
    "input": {
      "seed": 0
    }
  }'
```

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

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

## ElevenLabs Music tools and prices

- [ElevenLabs Music](https://spiral.ai/tools/elevenlabs/music) (ElevenLabs): $0.195 per minute of music.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| seed | 0 to 2147483647 | — | Random seed to initialize the music generation process. Providing the same seed with the same parameters can help achieve more consistent results, but exact reproducibility is not guaranteed and outputs may change across system updates. Cannot be used in conjunction with prompt. |
| prompt |  | — | A simple text prompt to generate a song from. Cannot be used in conjunction with `composition_plan`. |
| finetune_id |  | — | The ID of the finetune to use for the generation |
| lyrics_text |  | — | The lyrics text to use for the generation. |
| music_prompt |  | — | A music prompt. Deprecated. Use `composition_plan` instead. |
| output_format | auto, mp3_48000_128, mp3_48000_192, mp3_48000_240, mp3_48000_320, mp3_22050_32, mp3_24000_48, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_32000, pcm_44100, pcm_48000, ulaw_8000, alaw_8000, opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192 | auto | Output format of the generated audio. Formatted as codec_sample_rate_bitrate. Use "auto" (the default) to let the API pick the best format for the selected model: mp3_44100_128 for v1 models and mp3_48000_192 for v2 models. |

## What can you do with ElevenLabs Music in Gemini CLI?

Create music assets for a game's scenes, a product demo, or another project with ElevenLabs Music. Use project briefs and scripts to choose durations, instrumentation, and section structure.

### Podcast intros

Create a short instrumental opening with a clear mood, named instruments, and a defined tempo. Try a 15-second piano-and-bass cue for an interview show.

### Product demonstration backgrounds

Generate a restrained instrumental bed for a narrated demonstration. Specify sparse instrumentation and the length of the presentation.

### Game scene scores

Describe the scene and its emotional direction, such as a quiet exploration sequence or a tense encounter. Request the instrumentation and tempo that fit the action.

### Advertising music

Make a short musical cue around an ad's mood and running time. A 30-second upbeat funk brief can call for bass, rhythm guitar, and brass.

### Songwriting demos

Hear original lyrics as a vocal song before developing the arrangement further. Use a composition plan when verse and chorus placement matters.

### Songs in different languages

Create separate song demos with English, Spanish, German, or Japanese lyrics. Specify the language and musical direction for each recording.

### Short film scoring

Turn a written scene description into an instrumental score. Describe the emotional progression and use a composition plan for a structured build and resolution.

### Ambient backgrounds

Generate instrumental music for a calm video or listening session. Ask for sparse piano, soft synthesizers, and a slow tempo over a defined duration.

## Overview

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

## ElevenLabs Music in other agents

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

## More Gemini CLI guides

- [ElevenLabs Multilingual v2](https://spiral.ai/integrations/gemini-cli/elevenlabs-multilingual-v2)
- [ElevenLabs Music v2](https://spiral.ai/integrations/gemini-cli/elevenlabs-music-v2)
- [ElevenLabs Forced Alignment](https://spiral.ai/integrations/gemini-cli/elevenlabs-forced-alignment)
- [ElevenLabs Scribe v1](https://spiral.ai/integrations/gemini-cli/elevenlabs-scribe-v1)
- [ElevenLabs English Voice Changer v2](https://spiral.ai/integrations/gemini-cli/elevenlabs-english-voice-changer-v2)
- [ElevenLabs Scribe v2](https://spiral.ai/integrations/gemini-cli/elevenlabs-scribe-v2)

## Questions about ElevenLabs Music in Gemini CLI

**Can Gemini CLI use ElevenLabs Music?**

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

**How much does ElevenLabs Music cost in Gemini CLI?**

$0.195 per minute of music. 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 an ElevenLabs account to use ElevenLabs Music in Gemini CLI?**

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

**How long does it take to set up ElevenLabs Music in Gemini CLI?**

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

**Does Gemini CLI wait while ElevenLabs Music runs?**

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

**What is ElevenLabs Music useful for?**

Use it for vocal songs, instrumental backgrounds, and scores shaped around a scene or mood. Specific briefs work well for video soundtracks, advertising cues, and game music.

**How long can a track be?**

Prompt-based generation supports 3 seconds to 10 minutes. Choose the length around the actual use, such as a 15-second intro or a two-minute background track.

**Can ElevenLabs Music sing in other languages?**

Yes. Supported examples include English, Spanish, German, and Japanese; state the desired lyric language in your brief.

**How do I get music without singing?**

Include 'instrumental only' in the prompt. Name the instruments, mood, and tempo so the brief describes the backing track you need.

**When should I use a composition plan?**

Use a composition plan when the arrangement or lyric placement matters, such as an intro followed by a verse and chorus. A text prompt is a quicker starting point when you are still choosing a musical direction.

