Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · AudioReleased 2025-08-20

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.

Prompts to try with ElevenLabs Music in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

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.

ElevenLabs MusicGemini CLI
Try asking
  • 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:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    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.

    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.

    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.

ElevenLabs Music providers and prices

Spiral runs ElevenLabs Music through ElevenLabs. Open a card for today's price, with every fee included.

ElevenLabsAudio

Settings you can ask for

ElevenLabs Music works from your prompt and lyrics text. Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Seed0 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.

Output formatauto, mp3_48000_128, mp3_48000_192, mp3_48000_240, mp3_48000_320, mp3_22050_32, mp3_24000_48, mp3_44100_32 and 18 moreauto

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.

Sign with C2Paon or offoff

Whether to sign the generated song with C2PA. Applicable only for mp3 files.

MusicGenerationModetrack, loop, ambience, or video_to_music

Optional generation mode hint for prompt-based music generation. Can only be used with prompt.

Music length ms3000 to 600000

The length of the song to generate in milliseconds. Used only in conjunction with prompt. Must be between 3000ms and 600000ms. Optional - if not provided, the model will choose a length based on the prompt.

Finetune strengtha number up to 21

How strongly the finetune influences the generation. Defaults to 1.0 (full strength). Lower values soften the influence of the finetune, leaving more room for prompt-level steering. Only meaningful when finetune_id is also provided.

Force instrumentalon or offoff

If true, guarantees that the generated song will be instrumental. If false, the song may or may not be instrumental depending on the prompt. Can only be used with prompt.

Use phonetic nameson or offoff

If true, proper names in the prompt will be phonetically spelled in the lyrics for better pronunciation by the music model. The original names will be restored in word timestamps.

Store for inpaintingon or offoff

Whether to store the generated song for inpainting.

Respect sections durationson or offon

Controls how strictly section durations in the composition_plan are enforced. Only used with composition_plan and only applies to music_v1; for music_v2 and music_v2_5 section durations are always enforced and this is ignored. When false for music_v1, the model may adjust individual section durations for better quality and latency, while preserving the total song duration from the plan.

Every API field of ElevenLabs Music is on its tool page: open its card above.

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.

ElevenLabs Music success rate and speed on Spiral

Success and speed over the last 24 hours, across every run of these tools on Spiral.

Success rate
88.9%
Fastest median run time
8.2s
Runs, last 24 hours
36
ToolSuccessMedian timeRuns
ElevenLabs Music88.9%8.2s36

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.

Get started

Start using ElevenLabs Music in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options