Video Emotion API

Get Speaker Face Match Suggestions Route

Changed on

Return the stored speaker-face match suggestions for a video.

One item per in-scope speaker when eligible speakers were matched. Unresolved speakers have face_id and accuracy null and a reasoning explaining why. Never includes the internal match_evidence dict.

404 when no suggestions block exists (no run yet, in-flight after a trigger cleared the previous block, or after face/speaker add/delete/merge invalidation). A completed run that resolved nothing still 200s with all-null rows. If the requested scope has no eligible speakers, returns items: [] instead, with reason: "no_speakers" when the whole audio has no eligible speakers. A timed-out run can still have no block; use the statuses terminal flag to stop polling.

Auth matches the trigger POST: owner or admin only.

Error Responses

  • 401 Unauthorized: User is not authenticated or not authorized to access this video
  • 404 Not Found: Video not found, or no suggestions block is stored
get/v2/videos/{video_id}/speaker-face-match/suggestions

Request

  • Base URL
    https://api.imentiv.ai (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Path parameters

video_idstring required

Unique identifier of the video.

Response

Successful Response

reason'no_speakers' nullable

Completed audio has no eligible speakers; items is empty.

generated_atstring nullable
target_speaker_idsinteger[] nullable

Changes