IMimentiv
Video Emotion API

Retrieve Emotion Intensity

Changed on

Retrieve Emotion Intensity for a Specific Frame

get/v1/videos/{video_id}/frames/{frame_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 for which the frame's valence, arousal, and intensity are to be fetched.

frame_idstring required

The unique frame ID of the frame from which to fetch the valence, arousal, and intensity.

Query parameters

face_idstring nullable

The ID of the face whose valence, arousal, and intensity are to be retrieved. If not provided, these values for the entire frame will be returned.

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 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