Skip to main content
GET
List faces in a clip's camera

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

id
string
required

Video identifier

Example:

"vid_abc123def456"

clipId
string
required

Clip identifier

Example:

"cl_xyz789ghi012"

Query Parameters

startTimeMs
integer

Only return items at or after this time, in ms on the clip's playback timeline. Defaults to the clip's start.

Required range: 0 <= x <= 9007199254740991
Example:

60000

endTimeMs
integer

Only return items before this time (exclusive), in ms on the clip's playback timeline. Must be greater than startTimeMs. Defaults to the clip's end. Page through a long clip with windows that meet end to start.

Required range: 1 <= x <= 9007199254740991
Example:

120000

Response

OK

Faces from the clip's camera recording, placed on the video canvas. Moments when the layout hides the camera are left out. Empty when the clip has no camera or its recording has no detections yet (processing still running, or recorded before face detection)

samples
object[]
required