Upload image
POST/v0/uploads/images
Upload an image from the user’s video to get recommendations of tracks in the Epidemic Sound library that would work for the video. When you post the image to this endpoint, you will receive an ImageID in return. Use this ImageID in a request to the matching image endpoint to get track recommendations.
We currently support jpeg format and maximum file size is 2MB.
Request
- multipart/form-data
Body
Responses
- 200
- 400
- 401
- 429
Contains id to be used for endpoints requiring an image id, as well as the expiration date for the image.
- application/json
- Schema
- Example (from schema)
- Example
Schema
{
"imageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"expirationDate": "2024-07-29T15:51:28.071Z"
}
{
"imageId": "cf117c67-8959-4e0e-bf2c-6a121946a5db",
"expirationDate": "2024-10-12T07:29:34.279519771Z"
}
Bad request.
- application/json
- Schema
- Example (from schema)
- Example
Schema
Array [
]
Human readable message
errors
object[]
Error key
Error 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
Array [
]
Human readable message
errors
object[]
Error key
Error messages
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Invalid credentials"
}
Rate limit exceeded.
- application/json
- Schema
- Example (from schema)
- Example
Schema
Array [
]
Human readable message
errors
object[]
Error key
Error messages
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Rate limit exceeded"
}