Face liveness check
Checks whether the face in the image is a live capture rather than a presentation attack (printed photo, screen replay, mask). Costs 1 credit.
Authorizations
Your secret key (sk_live_…), server-side only. Also accepted as an x-api-key header.
Body
The image, in any supported form. Max 10 MB. EXIF orientation is applied automatically.
Base64-encoded image, or a full data URL. Alias: image.
http(s) URL we fetch server-side (10 s timeout). Alias: url. Provide either data or image_url.
Optional per-request decision threshold. Defaults to your org setting (0.5 unless changed).
0 <= x <= 1Unified only: per-product thresholds, e.g. {"face_liveness": 0.6, "deepfake": 0.4}.
Response
Scored check
face_liveness, deepfake genuine_score > threshold
real, spoof Calibrated score in [0,1].
The threshold actually applied (request override, org setting, or 0.5).
Always null for current models.
Model inference time.
Balance after this call.
Id of the logged detection session (visible in the console).
Quote this when contacting support.
