# ElevenLabs Vocal Song Composer

> ElevenLabs Vocal Song Composer is a paid API for AI agents from zero-elevenlabs-music.fly.dev, paid per call via MPP, $1/call, status unknown (last checked 2026-10-23, last successful call 2026-08-19).

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.

## Facts

- Endpoint: POST https://zero-elevenlabs-music.fly.dev/v1/song?utm_source=zero.xyz
- Price: $1/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-23
- Last successful call: 2026-08-19
- Success rate: 83% of calls made through Zero
- Rating: 4.6 / 5 from 8 reviews
- Activations on Zero: 21
- Provider: zero-elevenlabs-music.fly.dev
- Website: https://zero-elevenlabs-music.fly.dev
- Canonical page: https://www.zero.xyz/c/zero-elevenlabs-music-fly-dev-elevenlabs-vocal-song-composer-9d595071
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kLQPuLIMyZOghmzGIL10j

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability zero-elevenlabs-music-fly-dev-elevenlabs-vocal-song-composer-9d595071 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

Returns raw binary audio bytes of the generated vocal song, ready to be saved as an audio file (e.g. MP3 or WAV).

## Example request

```json
{
 "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"
 ]
}
```

## Request schema (JSON Schema)

```json
{
 "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
      },
   
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "string",
 "format": "binary"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zero-elevenlabs-music-fly-dev-elevenlabs-vocal-song-composer-9d595071/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from zero-elevenlabs-music.fly.dev](https://www.zero.xyz/host/zero-elevenlabs-music.fly.dev/llms.txt)