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

Claude Code · AudioReleased 2026-09-11

How to Use Elevenlabs Music v2.5 in Claude Code

Eleven Music v2.5 creates vocal songs and instrumental scores from text or structured composition plans. Compared with Eleven Music v2, it improves audio quality and how closely it follows your prompt.

Prompts to try with Elevenlabs Music v2.5 in Claude Code

Copy an example into Claude Code, or ask in your own words.

Read the game's opening-scene notes and use Eleven Music v2.5 to create a 60-second instrumental score. Use low strings, restrained percussion, and an uneasy mood at 80 BPM; divide it into discovery, rising tension, and resolution.

Elevenlabs Music v2.5Claude Code
Try asking
  • Use the project's demo script to brief Eleven Music v2.5 for a 30-second instrumental bed. Request warm electric piano, muted bass, dry drums, and an optimistic mood at 100 BPM, with space for narration.

  • Read the original lyrics in the project and use Eleven Music v2.5 to make a 90-second acoustic folk demo. Build a composition plan with a 10-second intro, 30-second verse, 30-second chorus, and 20-second outro.

  • Use the game's level descriptions to create three separate 30-second cues with Eleven Music v2.5: exploration, danger, and victory. Keep an orchestral palette, but give each cue a distinct tempo and mood; make all three instrumental.

  • Read the project's trailer outline and use Eleven Music v2.5 for a 45-second instrumental composition. Plan 15 seconds of sparse piano, 20 seconds of strings and percussion, and a 10-second resolution; request D minor and 90 BPM.

How to set up Elevenlabs Music v2.5 in Claude Code

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

Use Spiral's MCP server

  1. Add the hosted server

    This adds Spiral to the current project. Add --scope user to use it in every project.

    claude mcp add --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

Use the Spiral skill

  1. Send Claude Code 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 v2.5

    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": "fal",
        "model": "elevenlabs/music/v2.5",
        "input": {
          "prompt": "Mysterious original soundtrack, themes of jungle, rainforest, nature, woodwinds, busy rhythmic tribal percussion."
        }
      }'

Then paste one of the prompts above: Claude Code finds Elevenlabs Music v2.5 on Spiral, shows the price and runs it.

Elevenlabs Music v2.5 providers and prices

Spiral runs Elevenlabs Music v2.5 through fal. Open a card for today's price, with every fee included.

falAudio
Elevenlabs Music v2.5
elevenlabs/music/v2.5

Settings you can ask for

Elevenlabs Music v2.5 works from your prompt. Ask Claude Code for any of these in your prompt.

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

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.

Seeda whole number

Random seed to initialize the music generation process. Can only be used with composition_plan. The same seed with the same parameters gives more consistent results, but exact reproducibility is not guaranteed.

Output formatmp3_22050_32, mp3_24000_48, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, mp3_48000_128 and 17 moremp3_48000_192

Output format of the generated audio. Formatted as codec_sample_rate_bitrate. So an mp3 with 22.05kHz sample rate at 32kbs is represented as mp3_22050_32. Note that the μ-law format (sometimes written mu-law, often approximated as u-law) is commonly used for Twilio audio inputs.

Every API field of Elevenlabs Music v2.5 is on its tool page: open its card above.

What can you do with Elevenlabs Music v2.5 in Claude Code?

Create music assets that follow a game's scene notes, a video's script, or a project's creative brief. The coding agent can turn those files into prompts and composition plans for vocal demos or instrumental scores.

Podcast theme music

Create a short instrumental opening with a recognizable piano or guitar motif, then request a quieter ending for the host's introduction.

Video narration beds

Request restrained instrumental accompaniment with sparse percussion and no competing lead melody for an explainer or documentary.

Game scene scores

Describe a scene's mood and write separate sections for tension, confrontation, and resolution.

Songwriting demos

Turn original lyrics into a verse-and-chorus demo, specifying the vocal delivery, instruments, and musical direction for each section.

Multilingual song concepts

Develop vocal demos in English, Spanish, German, or Japanese while keeping the musical brief consistent.

Short advertising cues

Compose a 15- or 30-second instrumental cue with an opening hook and a defined final section for a product reveal.

Meditation accompaniment

Generate a slow instrumental piece with soft pads, sparse piano, and a restrained arrangement for a guided meditation.

Arrangement studies

Try the same original song brief as acoustic folk, dry soul, and orchestral music to compare instrumentation and production choices.

Questions about Elevenlabs Music v2.5 in Claude Code

Can Claude Code use Elevenlabs Music v2.5?

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Elevenlabs Music v2.5 like any built-in tool.

How much does Elevenlabs Music v2.5 cost in Claude Code?

$0.78 per 60,000 seconds. Billed on `music_length_ms`, default 600,000. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

Do I need a fal account to use Elevenlabs Music v2.5 in Claude Code?

No. Spiral runs Elevenlabs Music v2.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 Elevenlabs Music v2.5 in Claude Code?

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

Does Claude Code wait while Elevenlabs Music v2.5 runs?

Elevenlabs Music v2.5 runs in the background. Claude Code starts the run, checks on it and gives you the audio when it's ready.

What does Eleven Music v2.5 improve over Music v2?

ElevenLabs reports better audio quality and closer prompt following. Its launch announcement also describes more realistic instruments and arrangements with more layers and movement.

How long can Eleven Music v2.5 tracks be?

Tracks can run from 3 seconds to 10 minutes. In a composition plan, each chunk must last between 3 and 120 seconds.

Can Eleven Music v2.5 make songs in other languages?

Yes. Supported vocal languages include English, Spanish, German, and Japanese.

How do I keep vocals out of a track?

For a text prompt, enable the instrumental setting to guarantee a track without vocals. Describe the instruments and arrangement you want alongside that setting.

When should I use a composition plan?

Use a composition plan when you need to assign sections, place lyrics, or direct a complex arrangement. A simple text prompt is useful for trying an initial musical direction.

Get started

Start using Elevenlabs Music v2.5 in Claude Code

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

Paste this into Claude Code:

Set up Claude Code

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