Video

Measure emotional expression on faces in uploaded images or streamed video.

The video endpoints measure emotional expression on faces in JPEG images you upload or in video you stream as JPEG frames. For each face they detect, the endpoints return its bounding box. For the largest faces in each image, 2 by default, they also return two lists of scores: expressions, such as amusement, and descriptions of visible facial actions, such as smile.

Upload or realtime

Both endpoints return the same measurements for the same image. Upload takes a set of images in one request, and realtime takes video one frame at a time.

UploadRealtime
EndpointPOST /v1/expression/video/fileWSS /v1/expression/video/realtime
InputOne or more JPEG images in one request, up to 25 MBVideo frames, each a JPEG image in one binary frame
ResultsOne result per image, in the order the images were sentOne measurement.result for each measured frame
ConfigurationA config partsession.update, before the first frame
Face trackingface_id continues across requests when you pass back face_stateface_id follows the same face from frame to frame within a session
Recorded asA run under the run_idA run under the session_id

Next steps

Image upload

Upload JPEG images and receive scores for the faces in each image.

Video realtime

Stream video as JPEG frames and receive scores for the faces in each frame.