Détecter un visage
Localisez les visages dans une image avec des boîtes englobantes et des scores (pipeline Verifik).
menu_bookRéférence API : Face Detectionexpand_more
Documentation officielle : docs.verifik.co/verifik-biometrics-apis/liveness/face-detection (aperçu de la détection faciale, exemples de charge utile et forme de réponse).
Cette démo appelle POST /v2/face-recognition/detect avec min_score et search_mode selon la validation actuelle de l'API. collection_id et max_results sont pris en charge par le client mais n'apparaissent pas dans le formulaire ci-dessous.
POST /v2/face-recognition/detect
Renvoie les visages détectés avec géométrie et scores. Le guide publié documente aussi des drapeaux facultatifs comme return_landmarks lorsque pris en charge.
| En-tête | Valeur |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Param | Req. | Description |
|---|---|---|
| image | Oui | Image sonde en base64 (base64 brut ou data URI selon l'API) |
| min_score | Oui | Seuil, typiquement 0,5–1 |
| search_mode | Oui | FAST ou ACCURATE |
| collection_id | Non | Portée facultative (non utilisée dans cette UI démo) |
| max_results | Non | Plafond facultatif (non utilisé dans cette UI démo) |
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",
}),
});- Cette démo utilise detectFace de @humanauthn/api-client avec le jeton de votre session.
- Pour l'identification 1:N après capture, utilisez Face Search ou Search Live Face dans la documentation associée.
Documentation associée
Guides officiels sur docs.verifik.co
Face Search (1:N)
Recherche par image faciale parmi les personnes enrôlées.
Face Search 1:N (Live)
Vivacité sur l'image sonde puis recherche 1:N.
Face Search 1:N (Active User)
Recherche 1:N sans vivacité pour flux de session active.
Liveness Detection
Vérifier si un visage est vivant ou une tentative de spoof ; score de vivacité.
Face Comparison
Comparaison 1:1 pour vérifier l'identité contre une image de référence.
Compare with Liveness
Comparaison 1:1 plus détection de vivacité avec seuils configurables.