Skip to main content

Trigger Speaker Face Match

POST 
/v2/videos/:video_id/speaker-face-match

Trigger automatic AI-driven speaker-to-face matching for a video.

This endpoint initiates an asynchronous process that automatically matches speakers from the audio analysis to faces detected in the video using AI.

Prerequisites​

  • User must be the video owner or an admin
  • Video must be in 'completed' status
  • Audio must be in 'completed' status
  • Video must have an associated audio_id

Response​

{
  "video_id": "abc123",
  "audio_id": "xyz789",
  "status": "processing",
  "message": "Speaker-face match worker triggered successfully"
}

Error Responses​

  • 401 Unauthorized: User is not authenticated or not authorized to access this video
  • 404 Not Found: Video not found
  • 409 Conflict: Video or audio processing not completed
  • 400 Bad Request: Audio ID missing in video document

Request​

Responses​

Successful Response