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.

multipart/form-data

Request Body

file binary

Responses

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 uuid required
expirationDate date-time required

{
  "imageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "expirationDate": "2024-06-18T13:32:58.488Z"
}

{
  "imageId": "1042fe56-c4f0-478a-bc6a-2c9a18a38e54",
  "expirationDate": "2024-06-18T23:22:48.089193282Z"
}

Bad request.

application/json

Schema
Example (from schema)
Example

Schema

message string required
Human readable message
errors object[]
Array [
key string required
Error key
messages string[] required
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

message string required
Human readable message
errors object[]
Array [
key string required
Error key
messages string[] required
Error 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 required
Error key
messages string[] required
Error messages
]

{
  "message": "string",
  "errors": [
    {
      "key": "string",
      "messages": [
        "string"
      ]
    }
  ]
}

{
  "message": "Rate limit exceeded"
}