music-generation

Upload Music

Upload a music file to be later used for inpainting. Price for uploading is the same as the one for song generation. All uploaded content gets inspected for copyright infringement. If copyrighted content is detected, half of the request cost is still charged.

post/v1/music/upload

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Response

Successfully uploaded music file with optional composition plan

song_idstring required

Unique identifier for the uploaded song

waveform_visualinteger[] nullable

A low-resolution waveform of the uploaded song, for showing a preview of it. Holds 4 values per second of audio, from -1000 to 1000. Stereo is mixed down to a single channel. Only present if with_waveform_visual was True in the request body.

Example response

{
  "song_id": "jR4Xz8kL2mNpQ9wVtY1b"
}

Changes

Changed in 2 of the 30 revisions of this API.53

Aug 27, 2026352f205d118f2See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the optional property to the response with the status
  response-optional-property-added
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 20, 2026db6eec599cbe51See the full diff
- ▲
  removed subschema #2 from the request property anyOf list
  request-property-any-of-removed
- ▲
  removed the enum value false of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value music_v1 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value music_v2 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value true of the request property
  request-property-enum-value-removed
- ○
  added to the request property anyOf list
  request-property-any-of-added

Full history