Video Analysis

Upload a video and receive two analyses in parallel:

1. Video Analysis — scores (likeability, authenticity, clarity, confidence), strengths, areas for improvement, time-series scores, labeled moments, and detailed feedback.
2. Biometric Analysis — triage classification, emotion detection, governance (action flags, recommended actions), and a scientific interpretation narrative.

Response behavior

This endpoint has two response paths depending on how long the pipeline takes:

200 OK — synchronous result The full analysis is returned immediately in the response body. Typical for short videos where the pipeline completes within the synchronous window.

202 Accepted — asynchronous result The pipeline is still running. The response body contains a pollingUrl and sessionId. Poll GET /api/v1/full-analysis/{sessionId} until status == "complete", then read result.

Expect 202 in production. Most real-world videos take longer than the synchronous window. Always implement polling — do not assume a 200 will be returned.

Polling flow

POST /api/v1/full-analysis
  → 202 { sessionId, pollingUrl }
loop:
  GET /api/v1/full-analysis/{sessionId}
    → { status: "processing", progress: { phase, kpnPackagesSent, ... } }
  wait 3–5 seconds
until status == "complete":
  → { status: "complete", result: { video_analysis, biometric_analysis, transcript } }