Gesicht erkennen
Gesichter in einem Bild mit Begrenzungsrahmen und Werten lokalisieren (Verifik-Erkennungs-Pipeline).
menu_bookAPI-Referenz: Gesichtserkennungexpand_more
Offizielle Docs: docs.verifik.co/verifik-biometrics-apis/liveness/face-detection (Überblick Gesichtserkennung, Beispiel-Payloads und Antwortform).
Diese Demo ruft dieselbe Route POST /v2/face-recognition/detect mit min_score und search_mode auf, wie von der aktuellen API-Validierung gefordert. Optional collection_id und max_results werden vom Client unterstützt, im Formular unten aber nicht angeboten.
POST /v2/face-recognition/detect
Liefert erkannte Gesichter mit Geometrie und Werten. Der veröffentlichte Leitfaden zur Gesichtserkennung dokumentiert optional Flags wie return_landmarks, sofern unterstützt.
| Überschrift | Wert |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Parameter | Erf. | Beschreibung |
|---|---|---|
| image | Ja | Base64-Suchbild (rohes Base64 oder Data-URI laut API) |
| min_score | Ja | Schwelle, typisch 0,5–1 |
| search_mode | Ja | FAST oder ACCURATE |
| collection_id | Nein | Optionaler Bereich (in dieser Demo-UI nicht genutzt) |
| max_results | Nein | Optionale Obergrenze (in dieser Demo-UI nicht genutzt) |
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",
}),
});- Diese Demo nutzt detectFace aus @humanauthn/api-client mit Ihrem Sitzungstoken.
- Für 1:N-Identifikation nach der Erfassung siehe Gesichtssuche oder „Search Live Face“ in der zugehörigen Dokumentation.
Zugehörige Dokumentation
Offizielle Anleitungen auf docs.verifik.co
Face Search (1:N)
Suche per Gesichtsbild gegen registrierte Personen.
Face Search 1:N (Live)
Lebenderkennung auf dem Suchbild, danach 1:N-Suche.
Face Search 1:N (Active User)
1:N-Suche ohne Lebenderkennung für aktive Sitzungen.
Liveness Detection
Prüfen, ob ein Gesicht lebendig wirkt vs. Spoof; Lebendewert.
Face Comparison
1:1-Gesichtsvergleich zur Identitätsprüfung gegen ein Referenzbild.
Compare with Liveness
1:1-Vergleich plus Lebenderkennung mit konfigurierbaren Schwellen.