Yapper Docs
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

  • durationSeconds sets the exact length, from 10 to 300 seconds (default 60), and the price.
  • For vocals, write the lyrics into prompt under section headings such as [Verse] and [Chorus]; they are sung as written. Set instrumental: true for 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

FieldTypeRequiredDescription
promptstringyesWhat to generate.
disableAutoRetriesbooleannoDisable automatic same-model retries. Defaults to false, so automatic retries are enabled.
durationSecondsnumbernoTrack length in seconds, from 10 to 300 (default 60). The track is exactly this long and the price scales with it.
instrumentalbooleannotrue for a track with no vocals.
outputNamestringnoName 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.
stylestringnoOptional style line (genre, mood, instruments, tempo), sent ahead of the prompt.
titlestringnoOptional 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.

ModelNameDescriptionmodelOptions
elevenlabs-musicElevenLabs MusicElevenLabs Music v2.5: songs, beds and instrumentals at an exact length (10 seconds to 5 minutes), with lyrics sung as written.—

On this page