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.
Some models support longer content lengths than other models. To ensure you don't get broken results check here to see the maximum content length supported by each model.
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 |