Upload Music

import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
async function main() {
    const client = new ElevenLabsClient();
    await client.music.upload({});
}
main();

{
  "song_id": "jR4Xz8kL2mNpQ9wVtY1b",
  "composition_plan": {
    "positive_global_styles": [
      "pop",
      "rock",
      "jazz"
    ],
    "negative_global_styles": [
      "metal",
      "hip-hop",
      "country"
    ],
    "sections": [
      {
        "section_name": "Verse 1",
        "positive_local_styles": [
          "pop",
          "rock",
          "jazz"
        ],
        "negative_local_styles": [
          "metal",
          "hip-hop",
          "country"
        ],
        "duration_ms": 10000,
        "lines": [
          "Verse 1 lyrics"
        ]
      }
    ]
  }
}

Upload a music file to be later used for inpainting. Only available to enterprise clients with access to the inpainting API.

Request

This endpoint expects a multipart form containing a file.

filefileRequired

The audio file to upload.

extract_composition_planbooleanOptionalDefaults to false

Whether to generate and return the composition plan for the uploaded song. If True, the response will include the composition_plan but will increase the latency.

Response

Successfully uploaded music file with optional composition plan

song_idstring

Unique identifier for the uploaded song

composition_planobject or null

The composition plan extracted from the uploaded song. Only present if extract_composition_plan was True in the request body

Headers

Request

Response

Errors