v1

latestOpenAPI 3.1.02026-07-1381127211.1 KB
Video Emotion API

Retrieve Domination Emotion For A Specific Frame

This API endpoint is designed to fetch and return the dominant emotion of frames within a video based on its video_id. If face_id is provided, the dominant emotion of a specific face will be the output.

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

Path parameters

video_idstring required

Unique identifier of the video from which the frame’s dominant emotion is to be fetched.

Unique identifier of the video from which the frame’s dominant emotion is to be fetched.

frame_idstring required

The unique id of the frame from which the dominant emotion is to be fetched.

The unique id of the frame from which the dominant emotion is to be fetched.

Query parameters

face_idstring nullable

The id of the face whose dominant emotion is to be retrieved. If not provided, the dominant emotion for the entire frame will be returned.

The id of the face whose dominant emotion is to be retrieved. If not provided, the dominant emotion for the entire frame will be returned.

Response

Successful Response

frame_idstring required
face_idinteger nullable
dominant_emotionstring nullable
messagestring nullable