Upload image

POST 
https://partner-content-api.epidemicsound.com/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

file binary

Responses

200

Contains id to be used for endpoints requiring an image id, as well as the expiration date for the image.

application/json

Schema

Schema

imageId uuidrequired
expirationDate date-timerequired

Example (from schema)

{
  "imageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "expirationDate": "2024-07-29T15:51:28.071Z"
}

Example

{
  "imageId": "91a37fda-efbb-49a7-8f4c-9f600a4ee935",
  "expirationDate": "2024-10-12T09:01:46.690468032Z"
}

400

Bad request.

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

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

Example

{
  "message": "Bad request"
}

401

Unauthorized. Most likely your access token has expired.

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

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

Example

{
  "message": "Invalid credentials"
}

429

Rate limit exceeded.

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

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

Example

{
  "message": "Rate limit exceeded"
}

Authorization: http

name: UserAuthtype: httpdescription: User authentication is handled with short lived user access tokens.
 Use a partner token to request these tokens.
 The access token is of JWT format and should be passed in a header with your API requests:
 
 > **Example Header:** `Authorization: Bearer a-user-token`scheme: bearer

• curl
• python
• nodejs

• CURL

Request Collapse all

Base URL

https://partner-content-api.epidemicsound.com

Auth

Security Scheme

UserAuthEpidemicSoundConnectAuth

Bearer Token

Body

file

file

ResponseClear

Click the Send API Request button above and see the response here!