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

ElevenLabsAudioAvailable nowReleased 2025-08-20

ElevenLabs Music

music

Generate speech, music and audio with ElevenLabs Music through one Spiral API key. Composes a song from a prompt, or sings exact lyrics from a section-by-section plan; instrumental mode and up to 10 minutes. It runs in the background and returns audio. Pay as you go, with no subscription.

Run time p50 · last 24 hours
25.3s
Success rate · last 24 hours
90.0%

Pricing

$0.195 per minute of music.

Limits

Runs
In the background
Returns
audio
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
255 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
seednumber (whole)
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.

prompttext—

A simple text prompt to generate a song from. Cannot be used in conjunction with composition_plan.

finetune_idtext—

The ID of the finetune to use for the generation

lyrics_texttext—

The lyrics text to use for the generation.

music_promptJSON—

A music prompt. Deprecated. Use composition_plan instead.

output_formatone of
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.

sign_with_c2patrue or falsefalse

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

generation_modeone of
track, loop, ambience, video_to_music
—

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

music_length_msnumber (whole)
3000 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.

composition_planJSON—

A detailed composition plan to guide music generation. Cannot be used in conjunction with prompt.

finetune_strengthnumber
… to 2
1

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_instrumentaltrue or falsefalse

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_namestrue or falsefalse

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_inpaintingtrue or falsefalse

Whether to store the generated song for inpainting.

respect_sections_durationstrue or falsetrue

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.

Same request in code

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
    }
  }'

Frequently asked questions

How much does ElevenLabs Music cost?

$0.195 per minute of music. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use ElevenLabs Music through an API?

Send `POST /v1/runs` with `"provider": "elevenlabs"`, `"model": "music"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with ElevenLabs to use ElevenLabs Music?

No. Spiral runs it on its own ElevenLabs account and charges your Spiral balance.

Can my AI agent use ElevenLabs Music?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.