v1
latestOpenAPI 3.1.02026-07-1381127211.1 KBVideo Emotion API
Add Face
Create a placeholder face on a video file. The new face has no detection data — pair it with a speaker via Match Faces & Speakers when the AI missed a person. Auto-allocates face_id from a monotonic counter persisted on the doc (never reuses ids freed by delete). Cached CSV/PDF reports are invalidated since the report enumerates faces.
Returns the auto-allocated {face_id, name} so the FE can append the new tab without a re-read.
post/v1/videos/{video_id}/faces
Path parameters
video_idstring required
The unique video ID.
The unique video ID.
Response
Successful Response