Skip to main content

File Upload

Prior to initiating a job request for stem generation, it's essential to first upload the file(s) you intend to use for stem creation. To accomplish this, utilize the following /upload endpoints, which supports multipart/form-data requests. Upon successful upload, you will receive asset IDs that you'll subsequently employ in the next stage of the process.

Upload File (Multi-Part Form Data)​

To upload a file, you need to make a POST request to the /upload endpoint. The endpoint accepts a multipart/form-data request with the file to be uploaded. The response contains the ID of the uploaded file, which you can use to create a job request to generate a stem.

curl -L -X POST 'https://groovy.audioshake.ai/upload/' \
    -H 'Content-Type: multipart/form-data' \
    -F 'file=@/Users/Downloads/file2.mp3'

You can upload a file by providing a link to the file you want to upload. This route is our recommended method for uploading files. The endpoint accepts a JSON request with the link to the file you want to upload. The response contains the ID of the uploaded file, which you can use to create a job request to generate a stem.

curl -L -X POST 'https://groovy.audioshake.ai/upload/link' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer <TOKEN>' \
    --data '{
      "link": "string",
      "name": "string"
    }'

Response​

You can use the uploaded file's id to make stem generation requests. Here's an example payload:

{
  name: "<Your-File.mp3>",
  id: "clmgn7nkg50527f0mulbhwi6z8",
  fileType: "audio/mpeg",
  format: "mp3",
  link: "<LINK TO FILE>",
}