كشف الوجه
حدّد مواقع الوجوه في صورة مع مربعات إحاطة ودرجات (مسار كشف 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-Type | application/json |
| Authorization | Bearer <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 من الوثائق ذات الصلة.
الوثائق ذات الصلة
أدلة رسمية على docs.verifik.co
Face Search (1:N)
البحث بصورة وجه ضد الأشخاص المسجلين.
Face Search 1:N (Live)
الحضور الحي على صورة الاستطلاع، ثم بحث 1:N.
Face Search 1:N (Active User)
بحث 1:N دون حضور حي لتدفقات الجلسة النشطة.
Liveness Detection
تحديد ما إذا كان الوجه حيًا مقابل تزييف؛ درجة الحضور الحي.
Face Comparison
مقارنة وجه 1:1 للتحقق من الهوية ضد صورة مرجعية.
Compare with Liveness
مقارنة 1:1 مع كشف حضور حي وعتبات قابلة للضبط.