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.

1. 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.

You can test uploading a file on our API Routes & Endpoints.

Example Request:

curl -X 'POST' \
  'https://groovy.audioshake.ai/upload/' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer EXAMPLE' \
  -H 'Content-Type: multipart/form-data' \
  -F 'file=@audioshake-it-up-2min.mp3;type=audio/mpeg'

Input	Details
file	The file you wish to upload

2. Upload File with a Link

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.

You can test uploading a file link via our API Routes & Endpoints.

Example Request:

curl -X 'POST' \
  'https://groovy.audioshake.ai/upload/link' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer EXAMPLE' \
  -H 'Content-Type: application/json' \
  -d '{
  "link": "https://link-to-your-file",
  "name": "audioshake-it-up"
}'

Input	Details
link	The link to the publically available file you wish to upload
name	The desired name of the file once uploaded

3. Response

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

Example Response:

{
  "name": "audioshake-it-up",
  "id": "clyxaywtp00ne0jpi4nf435dv",
  "fileType": "audio/mpeg",
  "format": "mp3",
  "link": "YOUR_AUDIO_FILE_LINK"
}

Output	Details
name	The name of the uploaded file
id	The asset ID of the audio file used for job requests
fileType	The type of file (audio/mpeg, audio/wav, video/mp4, etc.)
format	The file extension
link	A link to download the file