IMimentiv
Video Emotion API

Get Single Frame

Changed on

One stored frame. Per-face emotion scores are on faces[].emotions; faces[].valence, arousal and intensity are computed from them, as in the frames list.

get/v1/videos/{video_id}/frames/{frame_id}

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 to be fetched.

frame_idstring required

The unique frame ID of the frame to be fetched.

Response

Successful Response

original_frame_imagestring nullable
frame_imagestring nullable

Deprecated: always null. Per-frame thumbnails are no longer produced.

found_facesinteger[] nullable
timestampinteger nullable
frame_idinteger nullable
notestring nullable

Example response

{
  "faces": [
    {
      "emotions": {
        "angry": 0.0003,
        "contempt": 0.0383,
        "disgust": 0.0019,
        "fear": 0.00004,
        "happy": 0.9505,
        "neutral": 0.008,
        "sad": 0.0002,
        "surprise": 0.0008
      }
    }
  ]
}

Changes

  • bd825cd86e8cRevision changes
    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required 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