IMimentiv
Video Emotion API

Get Valence Arousal

Changed on

Get emotion intensities of a video based on video_id.

valence and arousal are the averages over all faces in all frames (or over one face's frames when face_id is given); intensity is the length of that averaged (valence, arousal) vector. circumplex_version names the coordinate table the numbers come from.

get/v1/videos/{video_id}/valence_arousal

Request

  • Base URL
    https://api.imentiv.ai (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer
    • or OAuth 2
      Authorization code: https://api.imentiv.ai/oauth/authorize
      Token URL: https://api.imentiv.ai/oauth/token scopes: media.read

Path parameters

video_idstring required

The unique video ID of the video whose emotion intensity is to be fetched

Query parameters

face_idinteger nullable

Restrict the result to this face: the average is taken over the frames the face appears in. Omit it (or pass 0) to average over every face. Responds 404 if the video has no such face or the face appears in no frame.

Response

Successful Response

valencenumber required
arousalnumber required
intensitynumber required
circumplex_versionstring

Name of the valence/arousal coordinate table the numbers were computed with: each emotion label sits at a fixed (valence, arousal) point and a face's values are the score-weighted sum of those points. It reflects the table in use now, not the one in use when the video was analysed, and it changes only when the table does.

Example response

{
  "circumplex_version": "v2"
}

Changes

  • bd825cd86e8cRevision changes
    • info

      added the new optional query request parameter face_id

    • info

      added the optional property to the response with the status

  • 536bf48bb9fbRevision changes
    • info

      the endpoint scheme security ApiKeyAuth was added to the API

    • info

      the endpoint scheme security BearerAuth was added to the API

    • info

      the endpoint scheme security OAuth2Delegated was added to the API