Eleven Music v1
Eleven Music v1 is a text to music model for high quality multilingual tracks. Control structure, genre, and style at section level. Generate instrumentals or vocal songs from natural language prompts. Integrate through API for automated soundtrack and content workflows.
API Options
Platform-level options for task execution and delivery.
-
taskType
string required value: audioInference -
Identifier for the type of task being performed
-
taskUUID
string required UUID v4 -
UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.
-
outputType
string default: URL -
Audio output type.
Allowed values 3 values
-
outputFormat
string default: MP3 -
Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.
- `MP3`: Compressed audio, smaller file size.
- `WAV`: Uncompressed, high-quality audio.
- `FLAC`: Lossless compression.
- `OGG`: Open-source compressed audio format (Vorbis codec).
Allowed values 4 values
-
audioSettings
object -
Audio encoding settings for controlling the bitrate, number of channels, and sample rate of the generated audio. Only applicable for lossy output formats (
MP3andOGG). When using lossless formats (WAVorFLAC), this parameter must not be provided.The available sample rates and valid bitrate ranges depend on the output format. For
OGG, bitrate limits also vary by the number of channels.MP3 bitrate limits
Bitrate limits for MP3 are the same regardless of mono or stereo.
Sample Rate Min Bitrate Max Bitrate 8,000 Hz 8 kbps 64 kbps 11,025 Hz 8 kbps 64 kbps 12,000 Hz 8 kbps 64 kbps 16,000 Hz 8 kbps 160 kbps 22,050 Hz 8 kbps 160 kbps 24,000 Hz 8 kbps 160 kbps 32,000 Hz 32 kbps 320 kbps 44,100 Hz 32 kbps 320 kbps 48,000 Hz 32 kbps 320 kbps OGG bitrate limits — Mono (1 channel)
Sample Rate Min Bitrate Max Bitrate 8,000 Hz 8 kbps 40 kbps 12,000 Hz 16 kbps 48 kbps 16,000 Hz 16 kbps 96 kbps 24,000 Hz 16 kbps 80 kbps 48,000 Hz 32 kbps 224 kbps OGG bitrate limits — Stereo (2 channels)
Sample Rate Min Bitrate Max Bitrate 8,000 Hz 16 kbps 80 kbps 12,000 Hz 16 kbps 96 kbps 16,000 Hz 24 kbps 192 kbps 24,000 Hz 32 kbps 160 kbps 48,000 Hz 48 kbps 256 kbps Lossless formats: When
outputFormatis set toWAVorFLAC, theaudioSettingsparameter is not available since these formats produce uncompressed or lossless audio with no configurable encoding settings.Properties 3 properties
-
audioSettings»bitratebitrate
integer min: 8 -
Audio bitrate in kbps.
-
audioSettings»channelschannels
integer default: 2 -
Number of audio channels. 1 for mono, 2 for stereo.
Allowed values 2 values
-
audioSettings»sampleRatesampleRate
integer -
Audio sample rate in Hz.
-
-
webhookURL
string URI -
Specifies a webhook URL where JSON responses will be sent via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.
Learn more 1 resource
- Webhooks PLATFORM
- Webhooks
-
deliveryMethod
string default: sync -
Determines how the API delivers task results.
Allowed values 2 values
- Returns complete results directly in the API response.
- Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.
Learn more 1 resource
- Task Polling PLATFORM
-
uploadEndpoint
string URI -
Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.
Common use cases:
- Cloud storage: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- CDN integration: Upload to content delivery networks for immediate distribution.
// S3 presigned URL for secure upload https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600 // Google Cloud Storage presigned URL https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789 // Custom storage endpoint https://storage.example.com/uploads/generated-image.jpgThe content data will be sent as the request body to the specified URL when generation is complete.
-
ttl
integer min: 60 -
Time-to-live (TTL) in seconds for generated content. Only applies when
outputTypeisURL.
-
includeCost
boolean default: false -
Include task cost in the response.
-
numberResults
integer min: 1 max: 4 default: 1 -
Number of results to generate. Each result uses a different seed, producing variations of the same parameters.
Generation Parameters
Core parameters for controlling the generated content.
-
model
string required value: elevenlabs:1@1 -
Identifier of the model to use for generation.
Learn more 3 resources
-
positivePrompt
string min: 1 max: 2000 -
Text prompt describing elements to include in the generated output.
Learn more 2 resources
-
duration
integer min: 10 max: 300 -
Length of the generated audio track in seconds.
Provider Settings
Parameters specific to this model provider. These must be nested inside the providerSettings.elevenlabs object.
providerSettings.elevenlabs object.-
providerSettings»elevenlabs»musicmusic
object required -
Music generation configuration for ElevenLabs.
Properties 3 properties
-
providerSettings»elevenlabs»music»compositionPlancompositionPlan
object -
Defines global styles, sections, and timing for the generated track.
Properties 3 properties
-
providerSettings»elevenlabs»music»compositionPlan»negativeGlobalStylesnegativeGlobalStyles
array of strings required -
Styles excluded from the entire song.
-
providerSettings»elevenlabs»music»compositionPlan»positiveGlobalStylespositiveGlobalStyles
array of strings required -
Styles present in the entire song.
-
providerSettings»elevenlabs»music»compositionPlan»sectionssections
array of objects required min items: 1 -
Song sections with specific styling.
Properties 5 properties
-
providerSettings»elevenlabs»music»compositionPlan»sections»durationduration
integer required min: 3 max: 120 -
Duration of the section in seconds.
-
providerSettings»elevenlabs»music»compositionPlan»sections»lineslines
array of strings required -
Lyrics for the section.
-
providerSettings»elevenlabs»music»compositionPlan»sections»negativeLocalStylesnegativeLocalStyles
array of strings required -
Styles excluded from this section.
-
providerSettings»elevenlabs»music»compositionPlan»sections»positiveLocalStylespositiveLocalStyles
array of strings required -
Styles present in this section.
-
providerSettings»elevenlabs»music»compositionPlan»sections»sectionNamesectionName
string required min: 1 max: 100 -
Name of the section.
-
-
-
providerSettings»elevenlabs»music»forceInstrumentalforceInstrumental
boolean -
Generate an instrumental track without vocals.
-
providerSettings»elevenlabs»music»respectSectionsDurationsrespectSectionsDurations
boolean -
Strictly respect the duration specified for each section.
-
Clockwork Harbor Sprint Anthem
{
"taskType": "audioInference",
"taskUUID": "0ed97093-4cd3-4f7c-8f96-b795b80efab9",
"model": "elevenlabs:1@1",
"providerSettings": {
"elevenlabs": {
"music": {
"respectSectionsDurations": true,
"forceInstrumental": false,
"compositionPlan": {
"positiveGlobalStyles": [
"electro swing",
"brisk cinematic pop",
"mechanical groove",
"female and male vocal interplay",
"French and English lyrics",
"crisp brass stabs",
"driving bass",
"playful urgency"
],
"negativeGlobalStyles": [
"lofi",
"trap hats",
"heavy metal",
"ambient drone",
"orchestral ballad",
"8-bit arcade"
],
"sections": [
{
"sectionName": "Intro",
"positiveLocalStyles": [
"ticking percussion",
"muted trumpet phrases",
"tight upright bass",
"rising anticipation"
],
"negativeLocalStyles": [
"guitar solo",
"choir"
],
"duration": 12,
"lines": [
"Roues dentées, la ville s'élance",
"Copper sparks and coded chance",
"Every alley keeps the time",
"Tonight we run inside the chime"
]
},
{
"sectionName": "Verse",
"positiveLocalStyles": [
"nimble vocal phrasing",
"syncopated brass",
"punchy kick",
"urban mechanical swagger"
],
"negativeLocalStyles": [
"slow strings",
"melancholic piano"
],
"duration": 18,
"lines": [
"Steam on the river, feet on fire",
"Map of the docks like tangled wire",
"Clés dans la poche, cœur électrique",
"We chase the signal, sharp and quick",
"Neon is gone, but copper glows",
"The engine hums, the current knows"
]
},
{
"sectionName": "Chorus",
"positiveLocalStyles": [
"big singalong hook",
"layered vocals",
"wide brass lift",
"danceable release"
],
"negativeLocalStyles": [
"rap verse",
"minimalism"
],
"duration": 20,
"lines": [
"Run, run, through the turning town",
"Lift the gears and never slow down",
"Cours, cours, quand la cloche répond",
"We are the spark in the piston song"
]
},
{
"sectionName": "Bridge",
"positiveLocalStyles": [
"half-time break",
"whispered vocal lead-in",
"filtered drums",
"suspenseful harmonic shift"
],
"negativeLocalStyles": [
"full brass hits",
"crowd chants"
],
"duration": 10,
"lines": [
"Hold your breath when the turbines sleep",
"Under the bridge, the shadows keep",
"Un seul battement, puis tout revient",
"One more turn and we break the chain"
]
},
{
"sectionName": "Final Chorus",
"positiveLocalStyles": [
"anthemic climax",
"extra percussion",
"bright brass flourishes",
"call and response vocals"
],
"negativeLocalStyles": [
"soft fade",
"acoustic folk"
],
"duration": 20,
"lines": [
"Run, run, through the turning town",
"Lift the gears and never slow down",
"Cours, cours, le matin se lève",
"We are the pulse of the iron breath",
"Hands up high for the furnace dawn",
"Clockwork hearts keep carrying on"
]
}
]
}
}
}
}
}{
"taskType": "audioInference",
"taskUUID": "0ed97093-4cd3-4f7c-8f96-b795b80efab9",
"audioUUID": "d4a6e831-f0df-4daa-8638-2fd857ed9360",
"audioURL": "https://am.runware.ai/audio/os/a11d13/ws/5/ai/d4a6e831-f0df-4daa-8638-2fd857ed9360.mp3",
"cost": 0.09167
}Subway Percussion Chase Theme
{
"taskType": "audioInference",
"taskUUID": "886b84d7-bcd9-4171-b35e-b17657a7e395",
"model": "elevenlabs:1@1",
"positivePrompt": "Create an instrumental music track for a high-speed chase through an underground subway system in a near-future city. Start with tense muted synth pulses and clipped electronic percussion, then build into driving breakbeats, metallic impacts, deep bass motion, and sharp rhythmic stabs. The mood should feel urgent, sleek, mechanical, and exhilarating rather than dark horror. Add subtle station-announcement-like textures and train-track clatter woven musically into the groove. Midway, introduce a brief half-time section with echoing tension, then surge back into a bigger final run with layered synth hooks and powerful drums. Polished cinematic electronic style, memorable energy, no vocals.",
"duration": 58,
"providerSettings": {
"elevenlabs": {
"music": {
"forceInstrumental": true
}
}
}
}{
"taskType": "audioInference",
"taskUUID": "886b84d7-bcd9-4171-b35e-b17657a7e395",
"audioUUID": "f0f1ceb9-560a-418e-85e0-953b2c0662a6",
"audioURL": "https://am.runware.ai/audio/os/a10d08/ws/5/ai/f0f1ceb9-560a-418e-85e0-953b2c0662a6.mp3",
"cost": 0.53167
}Midnight Arcade Drift Anthem
{
"taskType": "audioInference",
"taskUUID": "dd03583c-a0e0-45f0-8a7e-ec05a2987e99",
"model": "elevenlabs:1@1",
"positivePrompt": "Create an instrumental electronic track with sleek night-drive energy, inspired by retro arcade racing and neon expressways. Start with pulsing analog synth bass, crisp drum machine grooves, shimmering pads, and bright arpeggios. Keep it catchy, cinematic, and momentum-driven, with a cool urban edge and a sense of forward motion. Include a confident melodic hook, subtle breakdown in the middle, then return with a bigger final lift. High production quality, clean mix, no vocals, no heavy metal guitars, no orchestral scoring, no lo-fi hiss.",
"duration": 78,
"providerSettings": {
"elevenlabs": {
"music": {
"forceInstrumental": true,
"respectSectionsDurations": false
}
}
}
}{
"taskType": "audioInference",
"taskUUID": "dd03583c-a0e0-45f0-8a7e-ec05a2987e99",
"audioUUID": "91f55fae-f712-4adf-81a1-6f8c63ba4ba8",
"audioURL": "https://am.runware.ai/audio/os/a14d18/ws/5/ai/91f55fae-f712-4adf-81a1-6f8c63ba4ba8.mp3",
"cost": 0.715
}Flooded Temple Drum Procession
{
"taskType": "audioInference",
"taskUUID": "26165833-6178-4893-8ddc-c4f8c7dccf9a",
"model": "elevenlabs:1@1",
"providerSettings": {
"elevenlabs": {
"music": {
"forceInstrumental": false,
"respectSectionsDurations": true,
"compositionPlan": {
"positiveGlobalStyles": [
"ritual percussion",
"feminine lead vocal",
"call and response chanting",
"low reeds",
"subtle electronic bass",
"humid ancient-cavern ambience",
"cinematic world fusion",
"multilingual lyrics"
],
"negativeGlobalStyles": [
"arcade sounds",
"chiptune",
"subway ambience",
"heavy metal guitars",
"country twang",
"cheerful pop claps"
],
"sections": [
{
"sectionName": "Opening Mist",
"positiveLocalStyles": [
"hushed entrance",
"distant frame drums",
"breathy solo vocal",
"echoing stone acoustics",
"sparse arrangement"
],
"negativeLocalStyles": [
"full choir",
"busy drum fills",
"bright synth lead"
],
"duration": 12,
"lines": [
"Aya no, aya no, the water keeps the names",
"Sous les arches noyées, nos pas restent légers"
]
},
{
"sectionName": "Torch Circle Verse",
"positiveLocalStyles": [
"steadier hand percussion groove",
"alternating solo and group responses",
"modal melody",
"rising tension"
],
"negativeLocalStyles": [
"trap hi hats",
"rock snare",
"comedic tone"
],
"duration": 18,
"lines": [
"We wake the drums where the old walls lean",
"Bajo la piedra dormida, canta la raíz",
"Hold the ember high, hold the echo clean",
"Aya no, aya no, bring the hidden tide"
]
},
{
"sectionName": "Current Gate Chorus",
"positiveLocalStyles": [
"anthemic ensemble vocals",
"larger drums",
"deep bass pulse",
"memorable refrain",
"expansive harmonic lift"
],
"negativeLocalStyles": [
"whispered delivery",
"jazzy swing",
"aggressive distortion"
],
"duration": 20,
"lines": [
"Open, open, current gate",
"Let the river turn our fate",
"Open, open, carry sound",
"Lift the lost and circle round"
]
},
{
"sectionName": "Echo Bridge",
"positiveLocalStyles": [
"percussion drop",
"reedy instrumental focus",
"half-spoken chant fragments",
"tense suspended harmony"
],
"negativeLocalStyles": [
"big chorus stack",
"dance beat",
"uplifting major-key release"
],
"duration": 10,
"lines": [
"Name by name, the chamber answers",
"Nom par nom, la mémoire revient"
]
},
{
"sectionName": "Final Ascent Chorus",
"positiveLocalStyles": [
"full rhythmic release",
"layered choir responses",
"strong closing hook",
"ceremonial climax"
],
"negativeLocalStyles": [
"minimalism",
"melancholy fade",
"soft ending"
],
"duration": 20,
"lines": [
"Open, open, current gate",
"Let the river turn our fate",
"Aya no, lift the fire through the flood",
"We return with thunder in the blood"
]
}
]
}
}
}
}
}{
"taskType": "audioInference",
"taskUUID": "26165833-6178-4893-8ddc-c4f8c7dccf9a",
"audioUUID": "f7e9e734-f100-4268-a722-24f4909d6633",
"audioURL": "https://am.runware.ai/audio/os/a23d05/ws/5/ai/f7e9e734-f100-4268-a722-24f4909d6633.mp3",
"cost": 0.09167
}