Upload audio
POST /v0/uploads/audio
Upload an audio file to get recommendations of similar tracks in the Epidemic Sound library. When you post the audio file to this endpoint, you will receive an AudioID in return. Use this AudioID in a request to the similar tracks endpoint to get track recommendations.
We currently support the formats: mp3, mpeg, ogg and vorbis. Maximum file size is 3.5MB. You can only upload music with the partner token, since we currently do not allow end users to use this feature.
- multipart/form-data
Request Body
- file binary
- 200
- 400
- 401
- 429
Returns the id of the uploaded audio, as well as the expiration date for the audio.
- application/json
- Schema
- Example (from schema)
- Example
Schema
- imageId uuid required
- expirationDate date-time required
{
"imageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"expirationDate": "2024-09-25T13:18:55.002Z"
}
{
"imageId": "ac57b84a-a3a5-4799-aa1d-d78939461e23",
"expirationDate": "2024-09-21T14:20:39.349877012Z"
}
Bad request.
- application/json
- Schema
- Example (from schema)
- Example
Schema
- message string required
Human readable message
errors object[]
Array [key string requiredError key
messages string[] requiredError messages
]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Bad request"
}
Unauthorized. Most likely your access token has expired.
- application/json
- Schema
- Example (from schema)
- Example
Schema
- message string required
Human readable message
errors object[]
Array [key string requiredError key
messages string[] requiredError messages
]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Invalid credentials"
}
Rate limit exceeded.
- application/json
- Schema
- Example (from schema)
- Example
Schema
- message string required
Human readable message
errors object[]
Array [key string requiredError key
messages string[] requiredError messages
]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Rate limit exceeded"
}