Detect Face
Locate faces in an image with bounding boxes and scores (OpenCV detect pipeline).
menu_bookAPI reference: Face Detectionexpand_more
Official docs: docs.verifik.co/verifik-biometrics-apis/liveness/face-detection (face detection overview, sample payloads, and response shape).
This demo calls the same POST /v2/face-recognition/detect route using min_score and search_mode as required by the current API validation. Optional collection_id and max_results are supported by the client but not exposed in the form below.
POST /v2/face-recognition/detect
Returns detected faces with geometry and scores. The published Face Detection guide also documents optional flags such as return_landmarks where supported.
| Header | Value |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Param | Req | Description |
|---|---|---|
| image | Yes | Base64 probe image (raw base64 or data URI per API) |
| min_score | Yes | Threshold, typically 0.5–1 |
| search_mode | Yes | FAST or ACCURATE |
| collection_id | No | Optional scope (not used in this demo UI) |
| max_results | No | Optional cap (not used in this demo UI) |
await fetch("https://api.verifik.co/v2/face-recognition/detect", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${accessToken}`,
},
body: JSON.stringify({
image: "<base64>",
min_score: 0.75,
search_mode: "FAST",
}),
});- This demo uses
detectFacefrom@humanauthn/api-clientwith your session token. - For 1:N identification after capture, use Face Search or Search Live Face from the related docs.
Related documentation
Official guides on docs.verifik.co
Face Search (1:N)
Search by face image against enrolled persons.
Face Search 1:N (Live)
Liveness on the probe image, then 1:N search.
Face Search 1:N (Active User)
1:N search without liveness for active-session flows.
Liveness Detection
Determine if a face is live vs spoof; liveness score.
Face Comparison
1:1 face comparison to verify identity against a reference image.
Compare with Liveness
1:1 comparison plus liveness detection with configurable thresholds.