كشف الوجه

كشف الوجه

حدّد مواقع الوجوه في صورة مع مربعات إحاطة ودرجات (مسار كشف Verifik).

menu_bookمرجع API: كشف الوجهexpand_more

الوثائق الرسمية: docs.verifik.co/verifik-biometrics-apis/liveness/face-detection (نظرة عامة على كشف الوجه، عيّنات الحمولات، وشكل الاستجابة).

يستدعي هذا العرض نفس مسار POST /v2/face-recognition/detect باستخدام min_score وsearch_mode كما تتطلب التحققات الحالية لواجهة البرمجة. يدعم العميل collection_id وmax_results اختياريًا لكنهما غير معروضين في النموذج أدناه.

POST /v2/face-recognition/detect

يعيد الوجوه المكتشفة مع الهندسة والدرجات. يوثّق دليل كشف الوجه المنشور أيضًا أعلامًا اختيارية مثل return_landmarks حيث يُدعم.

العنوانالقيمة
Content-Typeapplication/json
AuthorizationBearer <token>
المعاملإلزاميالوصف
imageنعمصورة استطلاع base64 (base64 خام أو data URI حسب واجهة البرمجة)
min_scoreنعمعتبة، عادة 0.5–1
search_modeنعمFAST أو ACCURATE
collection_idلانطاق اختياري (غير مستخدم في واجهة هذا العرض)
max_resultsلاحد أقصى اختياري (غير مستخدم في واجهة هذا العرض)
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",
  }),
});
  • يستخدم هذا العرض دالة detectFace من @humanauthn/api-client مع رمز الجلسة.
  • للتحديد 1:N بعد الالتقاط، استخدم Face Search أو Search Live Face من الوثائق ذات الصلة.
menu_book

أدلة رسمية على docs.verifik.co