Internal APIs

Face Frame Check

Validate a webcam frame for face suitability during enrollment.

POST/api/face-frame-check

Uses an AI vision model to classify a single webcam frame: count visible faces, determine if exactly one is suitable for an ID photo. Internal API used during attendee onboarding.

Authorization

Session Authentication

This is an internal API that requires an active browser session. It cannot be called with an API key.

Body Parameters

Parameter	Type	Required	Description
`imageDataUrl`	string	required	Base64-encoded data URL of the webcam frame (JPEG or PNG).

Responses

Frame analysis result.

{
  "faceCount": 1,
  "acceptable": true,
  "reason": "Single clear face detected"
}