Trigger 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