Songs

Get a song

Once status is ready, the response includes presigned download URLs for the instrumental and vocal stems.

Pass ?include=original to also get a URL for the file you uploaded, which is useful if you keep no local copy. It is opt-in because you are billed for storing the original either way, but signing it costs a lookup this endpoint does not otherwise need, and polling a running separation is its main job.

get/songs/{id}

Request

  • Base URL: https://vocaless.app/api/v1
  • URL: https://vocaless.app/api/v1/songs/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Song id.

Query parameters

include'original'

Comma-separated extras. Only original is supported, and it is omitted until the upload has landed.

Response

Success

created_atstring required
duration_secondsnumber nullable required
idstring required
namestring required
status'error' | 'ready' | 'separating' | 'uploaded' | 'uploading' required
instrumental_urlstring
original_urlstring
vocals_urlstring

Changes

No recorded changes to this operation across all 1 revision of this API.