{"uid":"cap_kLQPuLIMyZOghmzGIL10j","slug":"zero-elevenlabs-music-fly-dev-elevenlabs-vocal-song-composer-9d595071","name":"ElevenLabs Vocal Song Composer","description":"Generates a vocal song from a prompt, raw lyrics, structured sections, or a full ElevenLabs composition_plan. Supports genre, mood, instruments, vocals, tempo, key, negative styles, and section durations.","url":"https://zero-elevenlabs-music.fly.dev/v1/song?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","anyOf":[{"required":["prompt"]},{"required":["lyrics"]},{"required":["sections"]},{"required":["composition_plan"]}],"properties":{"key":{"type":"string","maxLength":40,"minLength":1},"seed":{"type":"integer","maximum":2147483647,"minimum":0},"avoid":{"type":"array","items":{"type":"string","maxLength":160,"minLength":1},"maxItems":20},"moods":{"type":"array","items":{"type":"string","maxLength":160,"minLength":1},"maxItems":12},"title":{"type":"string","maxLength":120,"minLength":1},"genres":{"type":"array","items":{"type":"string","maxLength":160,"minLength":1},"maxItems":12},"lyrics":{"type":"string","maxLength":12000,"minLength":1,"description":"Optional complete original lyrics. Section headings like [Verse] and [Chorus] are supported."},"prompt":{"type":"string","maxLength":4100,"minLength":1,"description":"Song concept and creative brief. Do not include artist names, existing song titles, or copyrighted lyrics."},"language":{"type":"string","maxLength":80,"minLength":1},"sections":{"type":"array","items":{"type":"object","required":["section_name","duration_ms"],"properties":{"lines":{"type":"array","items":{"type":"string","maxLength":200,"minLength":1},"maxItems":30,"description":"Lyrics for this section. Keep this to singable words only; put performance directions in styles."},"duration_ms":{"type":"integer","maximum":120000,"minimum":3000},"section_name":{"type":"string","maxLength":100,"minLength":1,"description":"Section label, such as Verse 1, Chorus, Bridge, or Outro."},"negative_local_styles":{"type":"array","items":{"type":"string","maxLength":160,"minLength":1},"maxItems":50,"description":"Section-specific styles to avoid."},"positive_local_styles":{"type":"array","items":{"type":"string","maxLength":160,"minLength":1},"maxItems":50,"description":"Section-specific musical and vocal directions."}},"additionalProperties":false},"maxItems":30,"minItems":1},"tempo_bpm":{"type":"integer","maximum":220,"minimum":40},"instruments":{"type":"array","items":{"type":"string","maxLength":160,"minLength":1},"maxItems":20},"vocal_style":{"type":"string","maxLength":160,"minLength":1},"output_format":{"type":"string","default":"mp3_44100_128"},"sign_with_c2pa":{"type":"boolean","default":false},"music_length_ms":{"type":"integer","default":60000,"maximum":90000,"minimum":3000},"composition_plan":{"type":"object","properties":{"sections":{"type":"array","items":{"type":"object","required":["section_name","duration_ms"],"properties":{"lines":{"type":"array","items":{"type":"string","maxLength":200,"minLength":1},"maxItems":30,"description":"Lyrics for this section. Keep this to singable words only; put performance directions in styles."},"duration_ms":{"type":"integer","maximum":120000,"minimum":3000},"section_name":{"type":"string","maxLength":100,"minLength":1,"description":"Section label, such as Verse 1, Chorus, Bridge, or Outro."},"negative_local_styles":{"type":"array","items":{"type":"string","maxLength":160,"minLength":1},"maxItems":50,"description":"Section-specific styles to avoid."},"positive_local_styles":{"type":"array","items":{"type":"string","maxLength":160,"minLength":1},"maxItems":50,"description":"Section-specific musical and vocal directions."}},"additionalProperties":false},"maxItems":30,"minItems":1},"negative_global_styles":{"type":"array","items":{"type":"string","maxLength":160,"minLength":1},"maxItems":50},"positive_global_styles":{"type":"array","items":{"type":"string","maxLength":160,"minLength":1},"maxItems":50}},"additionalProperties":false},"production_style":{"type":"string","maxLength":200,"minLength":1},"auto_generate_plan":{"type":"boolean","default":false,"description":"When true and no lyrics/sections/composition_plan are supplied, generate an ElevenLabs composition plan from prompt first."},"negative_global_styles":{"type":"array","items":{"type":"string","maxLength":160,"minLength":1},"maxItems":50},"positive_global_styles":{"type":"array","items":{"type":"string","maxLength":160,"minLength":1},"maxItems":50},"respect_sections_durations":{"type":"boolean","default":true}},"additionalProperties":false},"responseSchema":{"type":"string","format":"binary"},"example":{"request":{"key":"C major","moods":["uplifting","energetic","hopeful"],"title":"Rise Above","genres":["indie-pop","alternative pop"],"prompt":"Create an uplifting indie-pop song about overcoming challenges and finding inner strength. The song should have a hopeful, energetic vibe with a female vocal style. Include themes of resilience and personal growth.","language":"English","tempo_bpm":120,"instruments":["acoustic guitar","piano","drums","bass"],"vocal_style":"warm female voice with emotional delivery","output_format":"mp3_44100_128","music_length_ms":60000,"negative_global_styles":["heavy distortion","dark atmosphere","aggressive elements"],"positive_global_styles":["bright production","layered harmonies","indie sensibility"]},"response":{"_binary":true,"_nonJson":true,"_contentType":"audio/mpeg"}},"exampleRequest":{"key":"C major","moods":["uplifting","energetic","hopeful"],"title":"Rise Above","genres":["indie-pop","alternative pop"],"prompt":"Create an uplifting indie-pop song about overcoming challenges and finding inner strength. The song should have a hopeful, energetic vibe with a female vocal style. Include themes of resilience and personal growth.","language":"English","tempo_bpm":120,"instruments":["acoustic guitar","piano","drums","bass"],"vocal_style":"warm female voice with emotional delivery","output_format":"mp3_44100_128","music_length_ms":60000,"negative_global_styles":["heavy distortion","dark atmosphere","aggressive elements"],"positive_global_styles":["bright production","layered harmonies","indie sensibility"]},"tags":[],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":8,"rating":{"score":"0.90","successRate":"0.83","reviews":8,"stars":"4.6","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IkeZzxev0Uu222oiC9jJ1","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"elevenlabs-song-compose:v1:1"}],"brandName":"zero-elevenlabs-music.fly.dev","brandSlug":"zero-elevenlabs-music-fly-dev-mpp","brandBaseUrl":"https://zero-elevenlabs-music.fly.dev","brandDocsUrl":null,"whatItDoes":"Generates a full vocal song with lyrics from a prompt, raw lyrics, structured sections, or a composition plan, supporting genre, mood, instruments, tempo, key, and section-level styling.","exampleAgentPrompt":"Compose a full vocal pop song called 'Chasing Daylight' with a female voice, around 120 BPM in C major — include a verse about leaving home, a chorus about finding freedom, and a bridge; go for an uplifting indie-pop feel with piano and acoustic guitar, and avoid anything heavy or distorted.","exampleUseCases":null,"resultDescription":"Returns raw binary audio bytes of the generated vocal song, ready to be saved as an audio file (e.g. MP3 or WAV).","failureModes":["Missing required input: must supply at least one of prompt, lyrics, sections, or composition_plan (422 validation error)","Prompt contains copyrighted artist names or song titles — generation may be rejected or produce unexpected results","Section duration_ms out of range (must be 3000–120000ms) causes validation failure","tempo_bpm out of range (40–220) causes validation failure","ElevenLabs upstream service unavailable or overloaded — may return 502/503","Payment not attached or insufficient — endpoint requires $1 USDC per call","Overly long lyrics or prompt exceeding character limits cause 422 error"],"whenToPreferThis":"Choose this endpoint when you need a full vocal song with lyrics — not just an instrumental track. It is ideal when you want fine-grained control over sections (verse, chorus, bridge), specific tempo, key, genre, mood, and instruments. Use the companion instrumental endpoint if you only need background music without vocals.","instructions":null,"reviewSummary":"Consistently delivers full vocal songs (up to 90 seconds) with faithful lyrics reproduction across genres including EDM, K-pop, indie-folk, and R&B. Supports rich style controls — genre, tempo, key, instruments, vocal style, and negative styles — and accepts prompt, raw lyrics, section-tagged lyrics, or a full composition plan. Latency ranges from 30 seconds to 3 minutes; output is a clean 128kbps/44.1kHz stereo MP3. Duration enforcement for short-form outputs (under 60s) requires the sections input mode with explicit duration_ms.","reviewSummaryHighlights":["Faithfully reproduces custom lyrics with vocals across a wide range of genres","Rich styling controls including negative styles reliably steer mood and instrumentation","Flexible input modes: prompt, raw lyrics, section-tagged lyrics, or composition plan"],"reviewSummaryConcerns":["Duration not enforced for short-form requests via prompt mode — use sections input with explicit duration_ms instead","At $1 per call, pricing is higher than instrumental-only or simpler music generation alternatives"],"reviewSummaryGeneratedAt":"2026-08-20T12:18:12.610Z","activationCount":21,"lastUsedAt":"2026-09-30T06:54:38.991Z","lastSuccessfullyRanAt":"2026-08-19T19:32:35.362Z","lastHealthCheckAt":"2026-10-23T14:04:02.785Z","isFirstParty":false,"canonicalSlug":"zero-elevenlabs-music-fly-dev-elevenlabs-vocal-song-composer-9d595071"}