Recherche personne en direct
Vivacité sur une image sonde, puis recherche faciale 1:N (en direct).
menu_bookRéférence API : Face Search 1:N (Live)expand_more
Documentation officielle : docs.verifik.co/biometrics/search-live-face (vivacité sur l'image sonde, puis recherche 1:N).
URL de base https://api.verifik.co. Envoyez une seule sonde en base64 brut dans image (sans préfixe data URL), os obligatoire (ANDROID, IOS ou DESKTOP), seuils de vivacité et de correspondance et search_mode. Cette démo utilise DESKTOP.
POST /v2/face-recognition/search-live-face
Exécute d'abord l'anti-spoofing / vivacité ; si elle réussit, effectue une recherche par similarité sur les visages enrôlés.
| En-tête | Valeur |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Param | Req. | Description |
|---|---|---|
| image | Oui | Une seule image sonde en base64 |
| os | Oui | ANDROID, IOS ou DESKTOP |
| liveness_min_score | Oui | Seuil de vivacité (0,5–1,0) |
| min_score | Oui | Seuil de correspondance (0,5–1,0 selon la doc) |
| search_mode | Oui | FAST ou ACCURATE |
| collection_id | Non | Limiter la recherche à une collection |
await fetch("https://api.verifik.co/v2/face-recognition/search-live-face", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${accessToken}`,
},
body: JSON.stringify({
image: "<base64>",
os: "DESKTOP",
liveness_min_score: 0.65,
min_score: 0.75,
search_mode: "FAST",
collection_id: "<optionalCollectionMongoId>",
}),
});- Cette démo utilise searchLivePerson de @humanauthn/api-client avec le jeton de votre session.
- Les échecs sous le seuil de vivacité peuvent renvoyer une erreur (voir la doc pour le format).
Documentation associée
Guides officiels sur docs.verifik.co
L'objet Person
Champs et structure d'un enregistrement personne de reconnaissance faciale.
Lister toutes les personnes
Personnes de votre client, avec filtres facultatifs.
Obtenir une personne
Une personne par id.
Mettre à jour une personne
Profil, images, collections et plus.
Supprimer une personne
Supprime un enregistrement personne par id.
Face Search 1:N (Live)
Vivacité sur l'image sonde puis recherche 1:N.