Live-Person suchen

Lebenderkennung auf einem Suchbild, danach 1:N-Gesichtssuche (live).

menu_bookAPI-Referenz: Gesichtssuche 1:N (Live)expand_more

Offizielle Docs: docs.verifik.co/biometrics/search-live-face (Lebenderkennung auf dem Suchbild, danach 1:N-Suche).

Basis-URL https://api.verifik.co. Ein einzelnes rohes Base64-Suchbild in image (ohne data-URL-Präfix), erforderlich os (ANDROID, IOS oder DESKTOP), Schwellenwerte für Lebenderkennung und Abgleich sowie search_mode. Diese Demo nutzt DESKTOP.

POST /v2/face-recognition/search-live-face

Führt zuerst Anti-Spoofing / Lebenderkennung aus; bei Bestehen folgt die Ähnlichkeitssuche gegen registrierte Gesichter.

Überschrift	Wert
Content-Type	application/json
Authorization	Bearer <token>

Parameter	Erf.	Beschreibung
image	Ja	Einzelnes Base64-Suchbild
os	Ja	ANDROID, IOS oder DESKTOP
liveness_min_score	Ja	Lebenderkennungsschwelle (0,5–1,0)
min_score	Ja	Abgleichsschwelle (0,5–1,0 laut Docs)
search_mode	Ja	FAST oder ACCURATE
collection_id	Nein	Suche auf eine Sammlung beschränken

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>",
  }),
});

Diese Demo nutzt searchLivePerson aus @humanauthn/api-client mit Ihrem Sitzungstoken.
Werte unter der Lebenderkennungsschwelle können eine Fehlerantwort auslösen (Fehlerformate siehe API-Dokumentation).

menu_book

Offizielle Anleitungen auf docs.verifik.co

Object

The Person Object

Felder und Struktur eines Gesichtserkennungs-Personendatensatzes.

GET

List All Persons

Personen Ihres Mandanten mit optionalen Filtern.

GET

Retrieve a Person

Eine Person nach ID.

PUT