Gesichtsvergleich

Schritt 1 von 3
1
Quelle
2
Ziel
3
Analyse

Quelle — Identifikation

Die primäre biometrische Signatur für die Verifikation.

menu_bookAPI-Referenz: Gesichtsvergleichexpand_more

Offizielle Docs: docs.verifik.co/biometrics/compare

Die öffentlichen Verifik-Seiten können weitere Felder für andere Umgebungen beschreiben. Diese HumanAuthn-Demo nutzt die Verifik-Route mit gallery, probe und optional compare_min_score.

POST /v2/face-recognition/compare

Vergleicht Suchbild(er) mit Referenzbild(ern) und liefert einen Ähnlichkeitswert. Das Backend setzt passed, wenn der Wert Ihren compare_min_score erreicht (oder den Server-Standard, falls nicht angegeben).

ÜberschriftWert
Content-Typeapplication/json
AuthorizationBearer <token>
ParameterTypErf.Beschreibung
gallerystring[]JaReferenzgesicht(er), Base64 (ohne data-URL-Präfix)
probestring[]JaAbzugleichende Gesicht(er), Base64
compare_min_scorenumberNein0,67 bis 0,95. Server-Standard 0,85, falls nicht gesetzt
await fetch("https://api.verifik.co/v2/face-recognition/compare", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    gallery: ["<base64>"],
    probe: ["<base64>"],
    compare_min_score: 0.85,
  }),
});
// 200 OK, example shape
{
  "id": "…",
  "data": {
    "result": {
      "score": 0.91,
      "compare_min_score": 0.85,
      "passed": true
    },
    "compare_min_score": 0.85
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "…"
  }
}
  • Bilder müssen echte Base64-Nutzdaten sein. Sehr kurze Zeichenketten werden abgewiesen (z. B. 412:only_images_in_base64).
  • Der Schieberegler „Mindestwert für Vergleich“ setzt compare_min_score in der Anfrage (0,67 bis 0,95; Startwert ist der API-Client-Standard 0.85).
  • Antworten enthalten oft id und einen Signaturblock neben data.