POST

Try POST /v1/music/stream — ElevenLabs API

ElevenLabs playground

Stream Composed Music

Credentials

ElevenLabs API key · sent as xi-api-key

Kept in this tab only. Requests go through apicheats.dev's same-origin proxy straight to api.elevenlabs.io; the proxy stores and logs nothing about them.

Query

output_format · optional · string Output format of the generated audio. Formatted as codec_sample_rate_bitrate. Use "auto" (the default) to let the API pick the best format for the selected model: mp3_44100_128 for v1 models and mp3_48000_192 for v2 models. enable_logging · optional · boolean When enable_logging is set to false zero retention mode will be used for the request. Zero retention mode may only be used by enterprise customers.

Body application/json

{
  "prompt": "example-prompt",
  "generation_mode": "track",
  "music_prompt": {
    "negative_global_styles": [
      "metal",
      "hip-hop",
      "country"
    ],
    "positive_global_styles": [
      "pop",
      "rock",
      "jazz"
    ],
    "sections": [
      {
        "duration_ms": 10000,
        "lines": [
          "Verse 1 lyrics"
        ],
        "negative_local_styles": [
          "metal",
          "hip-hop",
          "country"
        ],
        "positive_local_styles": [
          "pop",
          "rock",
          "jazz"
        ],
        "section_name": "Verse 1"
      }
    ]
  },
  "lyrics_text": "example-lyrics-text",
  "composition_plan": {
    "negative_global_styles": [
      "metal",
      "hip-hop",
      "country"
    ],
    "positive_global_styles": [
      "pop",
      "rock",
      "jazz"
    ],
    "sections": [
      {
        "duration_ms": 10000,
        "lines": [
          "Verse 1 lyrics"
        ],
        "negative_local_styles": [
          "metal",
          "hip-hop",
          "country"
        ],
        "positive_local_styles": [
          "pop",
          "rock",
          "jazz"
        ],
        "section_name": "Verse 1"
      }
    ]
  },
  "music_length_ms": 0,
  "model_id": "music_v1",
  "seed": 0,
  "force_instrumental": false,
  "finetune_id": "finetune-id",
  "finetune_strength": 1,
  "use_phonetic_names": false,
  "store_for_inpainting": false
}

13 body fields

prompt · optional · string — A simple text prompt to generate a song from. Cannot be used in conjunction with `composition_plan`.
generation_mode · optional · string — Optional generation mode hint for prompt-based music generation. Can only be used with `prompt`.
music_prompt · optional · object — A music prompt. Deprecated. Use `composition_plan` instead.
lyrics_text · optional · string — The lyrics text to use for the generation.
composition_plan · optional · object — A detailed composition plan to guide music generation. Cannot be used in conjunction with `prompt`.
music_length_ms · optional · integer — 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.
model_id · optional · string — Request body field model_id.
seed · optional · integer — Random seed to initialize the music generation process. Providing the same seed with the same parameters can help achieve more consistent results, but exact reproducibility is not guaranteed and outputs may change across system updates. Cannot be used in conjunction with prompt.
force_instrumental · optional · boolean — 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`.
finetune_id · optional · string — The ID of the finetune to use for the generation
finetune_strength · optional · number — How strongly the finetune influences the generation. Defaults to 1.0 (full strength). Lower values soften the influence of the finetune, leaving more room for prompt-level steering. Only meaningful when `finetune_id` is also provided.
use_phonetic_names · optional · boolean — If true, proper names in the prompt will be phonetically spelled in the lyrics for better pronunciation by the music model. The original names will be restored in word timestamps.
store_for_inpainting · optional · boolean — Whether to store the generated song for inpainting.