Yüz algıla

Sınırlayıcı kutular ve skorlarla görüntüdeki yüzleri bulun (Verifik algılama hattı).

menu_bookAPI referansı: Yüz algılamaexpand_more

Resmi belgeler: docs.verifik.co/verifik-biometrics-apis/liveness/face-detection (yüz algılamaya genel bakış, örnek yükler ve yanıt şekli).

Bu demo, mevcut API doğrulamasının gerektirdiği min_score ve search_mode kullanarak aynı POST /v2/face-recognition/detect rotasını çağırır. İsteğe bağlı collection_id ve max_results istemci tarafından desteklenir ancak aşağıdaki formda açığa çıkmaz.

POST /v2/face-recognition/detect

Geometri ve skorlarla algılanan yüzleri döndürür. Yayınlanan Yüz algılama kılavuzu, desteklendiğinde return_landmarks gibi isteğe bağlı bayrakları da belgeler.

Başlık	Değer
Content-Type	application/json
Authorization	Bearer <token>

Param	Zorunlu	Açıklama
image	Evet	Base64 prob görüntüsü (API’ye göre ham base64 veya data URI)
min_score	Evet	Eşik, tipik olarak 0,5–1
search_mode	Evet	FAST veya ACCURATE
collection_id	Hayır	İsteğe bağlı kapsam (bu demo UI’da kullanılmaz)
max_results	Hayır	İsteğe bağlı üst sınır (bu demo UI’da kullanılmaz)

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

Bu demo, oturum belirtecinizle @humanauthn/api-client içindeki detectFace kullanır.
Yakalama sonrası 1:N tanımlama için ilgili belgelerden Yüz araması veya Canlı yüz ara kullanın.

menu_book

docs.verifik.co üzerindeki resmi kılavuzlar

POST

Yüz araması (1:N)

Kayıtlı kişilere yüz görüntüsüyle arama.

POST

Yüz araması 1:N (canlı)

Prob görüntüsünde canlılık, ardından 1:N arama.

POST

Yüz araması 1:N (aktif kullanıcı)

Aktif oturum akışları için canlılık olmadan 1:N arama.

POST