Models & Inputs
Music generation
Songs, beds and instrumentals at a set length, with lyrics sung as written.
POST /api/v1/processes with "type": "music-generation". Pick any model — the API does not plan-gate models. GET /api/v1/models returns the same capabilities at runtime.
Writing music requests
durationSecondssets the exact length, from 10 to 300 seconds (default 60), and the price.- For vocals, write the lyrics into
promptunder section headings such as[Verse]and[Chorus]; they are sung as written. Setinstrumental: truefor no vocals. - Describe the sound (genre, mood, instruments, tempo). Prompts that name an artist or song to imitate are refused, and the error suggests a rewrite.
- The finished track is an mp3 audio asset on the process outputs.
Pricing
elevenlabs-music: 20 credits per 30 seconds started (40 for a 60-second track, 200 for 300 seconds).
Input fields
| Field | Type | Required | Description |
|---|---|---|---|
prompt | string | yes | What to generate. |
disableAutoRetries | boolean | no | Disable automatic same-model retries. Defaults to false, so automatic retries are enabled. |
durationSeconds | number | no | Track length in seconds, from 10 to 300 (default 60). The track is exactly this long and the price scales with it. |
instrumental | boolean | no | true for a track with no vocals. |
outputName | string | no | Name for the output asset, up to 80 characters. It is stored as a lowercase hyphenated slug ("ORD-17 Concept A" becomes ord-17-concept-a), so use metadata for exact identifiers. |
style | string | no | Optional style line (genre, mood, instruments, tempo), sent ahead of the prompt. |
title | string | no | Optional track title. |
Example
Add "dryRun": true to get the exact credit cost without starting, and always send an Idempotency-Key header on real starts.
POST /api/v1/processes
{
"type": "music-generation",
"model": "elevenlabs-music",
"input": {
"prompt": "Warm lo-fi hip hop bed: dusty drums at 88 BPM, Rhodes chords, round bass, light vinyl crackle.",
"durationSeconds": 60,
"instrumental": true
}
}Models
Cost depends on the input — use dryRun: true for an exact quote.
| Model | Name | Description | modelOptions |
|---|---|---|---|
elevenlabs-music | ElevenLabs Music | ElevenLabs Music v2.5: songs, beds and instrumentals at an exact length (10 seconds to 5 minutes), with lyrics sung as written. | — |