{"models":[{"endpoint_id":"elevenlabs/music/v2.5","metadata":{"display_name":"Elevenlabs Music v2.5","category":"text-to-audio","description":"Generate high quality, realistic music with fine controls using Elevenlabs Music v2.5!","status":"active","tags":["music","text-to-music"],"updated_at":"2026-11-08T03:23:16.269Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0aaa6adb/-Z3Ays503mRIC-atq70g8.jpg","model_url":"https://fal.run/elevenlabs/music/v2.5","license_type":"commercial","date":"2026-09-14T17:20:06.936Z","highlighted":false,"kind":"inference","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for fal-ai/elevenlabs/music/v2.5","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/elevenlabs/music/v2.5 queue.","x-fal-metadata":{"endpointId":"fal-ai/elevenlabs/music/v2.5","playgroundUrl":"https://fal.ai/models/fal-ai/elevenlabs/music/v2.5","documentationUrl":"https://fal.ai/models/fal-ai/elevenlabs/music/v2.5/api","about":"ElevenLabs Music v2.5.\n\nGenerates a song from a text prompt or a chunk-based composition plan\nwith the ``music_v2_5`` model -- ElevenLabs' most capable music model,\nbuilding on v2 with improved audio quality and prompt adherence."}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Fal Key"}},"schemas":{"QueueStatus":{"type":"object","properties":{"status":{"type":"string","enum":["IN_QUEUE","IN_PROGRESS","COMPLETED"]},"request_id":{"type":"string","description":"The request id."},"response_url":{"type":"string","description":"The response url."},"status_url":{"type":"string","description":"The status url."},"cancel_url":{"type":"string","description":"The cancel url."},"logs":{"type":"object","description":"The logs.","additionalProperties":true},"metrics":{"type":"object","description":"The metrics.","additionalProperties":true},"queue_position":{"type":"integer","description":"The queue position."}},"required":["status","request_id"]},"ElevenlabsMusicV25Input":{"properties":{"composition_plan":{"anyOf":[{"$ref":"#/components/schemas/MusicV2CompositionPlan"},{"type":"null"}],"description":"The chunk-based composition plan for the music"},"enable_safety_checker":{"type":"boolean","default":true,"description":"Check input content for safety. Disabling requires account authorization.","title":"Enable Safety Checker"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"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.","title":"Seed"},"force_instrumental":{"type":"boolean","default":false,"description":"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.","title":"Force Instrumental"},"music_length_ms":{"anyOf":[{"type":"integer","maximum":600000,"minimum":3000},{"type":"null"}],"description":"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.","title":"Music Length Ms"},"output_format":{"type":"string","default":"mp3_48000_192","description":"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.","enum":["mp3_22050_32","mp3_24000_48","mp3_44100_32","mp3_44100_64","mp3_44100_96","mp3_44100_128","mp3_44100_192","mp3_48000_128","mp3_48000_192","mp3_48000_240","mp3_48000_320","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"],"title":"Output Format"},"prompt":{"examples":["Mysterious original soundtrack, themes of jungle, rainforest, nature, woodwinds, busy rhythmic tribal percussion."],"description":"The text prompt describing the music to generate","anyOf":[{"maxLength":4100,"type":"string"},{"type":"null"}],"title":"Prompt"}},"type":"object","x-fal-order-properties":["prompt","enable_safety_checker","composition_plan","music_length_ms","force_instrumental","seed","output_format"],"description":"Request format for the ElevenLabs Music v2 / v2.5 API.","title":"MusicV2Request"},"ElevenlabsMusicV25Output":{"properties":{"audio":{"examples":[{"content_type":"audio/mpeg","url":"https://storage.googleapis.com/falserverless/example_outputs/elevenlabs/music_generated.mp3","file_name":"music_generated.mp3"}],"description":"The generated music audio file in MP3 format","$ref":"#/components/schemas/File"}},"title":"MusicOutput","required":["audio"],"x-fal-order-properties":["audio"],"type":"object"},"MusicV2CompositionPlan":{"properties":{"chunks":{"title":"Chunks","type":"array","items":{"$ref":"#/components/schemas/MusicGenerationChunk"},"description":"The chunks that make up the generation, in order. At most 30 chunks, totalling between 3000ms and 600000ms.","minItems":1,"maxItems":30}},"title":"MusicV2CompositionPlan","required":["chunks"],"x-fal-order-properties":["chunks"],"type":"object"},"File":{"properties":{"file_size":{"examples":[4404019],"description":"The size of the file in bytes.","anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Size"},"content_type":{"examples":["image/png"],"description":"The mime type of the file.","anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"url":{"type":"string","description":"The URL where the file can be downloaded from.","title":"Url"},"file_name":{"examples":["z9RV14K95DvU.png"],"description":"The name of the file. It will be auto-generated if not provided.","anyOf":[{"type":"string"},{"type":"null"}],"title":"File Name"}},"title":"File","required":["url"],"x-fal-order-properties":["url","content_type","file_name","file_size"],"type":"object"},"MusicGenerationChunk":{"properties":{"positive_styles":{"title":"Positive Styles","items":{"type":"string"},"description":"The styles and musical directions that should be present in this chunk. Use English for best results. The styles of the first chunk matter most as they set the overall tone and genre; later chunks can add nuance, progression or change direction.","examples":[["synthwave","analog drum machine","great production quality"]],"type":"array"},"audio_reference":{"anyOf":[{"$ref":"#/components/schemas/MusicAudioReference"},{"type":"null"}],"description":"An audio clip whose style conditions this chunk. The reference on the first chunk matters most: it influences every later chunk, so condition from the first chunk to style the whole song."},"context_adherence":{"anyOf":[{"enum":["low","medium","high"],"type":"string"},{"type":"null"}],"description":"How closely this chunk follows the context of its surrounding chunks. Low adherence lets the model deviate and be more creative, high adherence keeps it consistent with the surrounding context.","title":"Context Adherence"},"text":{"type":"string","examples":["[Verse 1]\nNeon rain on empty streets\nI keep walking to the beat"],"description":"The text to generate for this chunk. Can start with an optional section name in square brackets, e.g. [Verse 1], followed by lyric lines, plus inline directions in curly braces, e.g. {scratching}. Section names must be between 1 and 100 characters. At most 30 lines are allowed, each at most 200 characters.","title":"Text"},"negative_styles":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"The styles and musical directions that should not be present in this chunk. Leaving this empty is a good default; only set it to explicitly avoid a particular style or direction.","title":"Negative Styles"},"duration_ms":{"title":"Duration Ms","type":"integer","description":"The duration of the chunk in milliseconds. Must be between 3000ms and 120000ms.","maximum":120000,"minimum":3000}},"type":"object","required":["text","duration_ms","positive_styles"],"x-fal-order-properties":["text","duration_ms","positive_styles","negative_styles","context_adherence","audio_reference"],"description":"One generation chunk of a ``music_v2`` / ``music_v2.5`` composition plan.\n\nThe v2 models replaced v1's ``sections`` (``MusicPrompt``) with ``chunks``\n(``CompositionPlan``); the two shapes are not interchangeable -- sending a\nv1 section plan to a v2 model (or vice versa) is rejected by ElevenLabs.","title":"MusicGenerationChunk"},"MusicAudioReference":{"properties":{"start_ms":{"title":"Start Ms","default":0,"type":"integer","description":"Offset into the clip where the referenced window starts, in milliseconds.","minimum":0},"end_ms":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"description":"Offset into the clip where the referenced window ends, in milliseconds. Defaults to 30000ms after start_ms, or the end of the clip if it is shorter. The window must be at most 30000ms long.","title":"End Ms"},"audio_url":{"type":"string","examples":["https://storage.googleapis.com/falserverless/example_outputs/elevenlabs/music_generated.mp3"],"description":"URL of the audio clip to use as the style reference.","title":"Audio Url"},"strength":{"anyOf":[{"enum":["low","medium","high","xhigh"],"type":"string"},{"type":"null"}],"description":"How strongly the model follows the reference. Low lets it deviate and be more creative, high keeps it close to the reference.","title":"Strength"}},"type":"object","required":["audio_url"],"x-fal-order-properties":["audio_url","start_ms","end_ms","strength"],"description":"An audio clip whose style conditions a ``music_v2`` / ``music_v2.5`` chunk.\n\nElevenLabs conditions on a *song id*, which only exists after the clip has\nbeen uploaded to them, so the app uploads on the caller's behalf and caches\nthe resulting id (see ``ElevenLabsTTS._resolve_audio_reference``).","title":"MusicAudioReference"}}},"paths":{"/fal-ai/elevenlabs/music/v2.5/requests/{request_id}/status":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}},{"name":"logs","in":"query","required":false,"schema":{"type":"number","description":"Whether to include logs (`1`) in the response or not (`0`)."}}],"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/elevenlabs/music/v2.5/requests/{request_id}/cancel":{"put":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"The request was cancelled.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request was cancelled successfully."}}}}}}}}},"/fal-ai/elevenlabs/music/v2.5":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ElevenlabsMusicV25Input"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/elevenlabs/music/v2.5/requests/{request_id}":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"Result of the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ElevenlabsMusicV25Output"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}}],"next_cursor":null,"has_more":false}
