الانتقال إلى المحتوى الرئيسي
ستتناول هذه الوثيقة تعليمات دمج API لكشف الحيّة الثابتة للوجه (الإصدار عالي الدقة)، والتي يمكن استخدامها للكشف عن الصور الثابتة التي يرفعها المستخدمون لمنع إعادة التصوير، لتحديد ما إذا كانت الصورة المعاد تصويرها.

​
عملية التقديم

لاستخدام API، يجب أولاً الذهاب إلى كشف الحيّة الثابتة للوجه (الإصدار عالي الدقة) API وتقديم طلب الخدمة المناسبة، بعد الدخول إلى الصفحة، انقر على زر “Acquire”، كما هو موضح في الصورة: إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، سيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، بعد تسجيل الدخول والتسجيل، سيتم العودة تلقائيًا إلى الصفحة الحالية. عند التقديم لأول مرة، سيكون هناك حد مجاني متاح، يمكنك استخدام API مجانًا.

​
الاستخدام الأساسي

أولاً، يجب أن نفهم طريقة الاستخدام الأساسية، وهي إدخال رابط الصورة، للحصول على صورة النتائج المعالجة، يجب أولاً تمرير حقل image_url، صورة الوجه كما هو موضح في الصورة أدناه:

يمكننا بعد ذلك ملء المحتوى المقابل على الواجهة، كما هو موضح في الصورة:

يمكنك أن ترى هنا أننا قمنا بتعيين رؤوس الطلب، بما في ذلك:
  • accept: نوع الاستجابة التي ترغب في تلقيها، هنا يتم ملؤها بـ application/json، أي بتنسيق JSON.
  • authorization: مفتاح API، بعد التقديم يمكنك اختياره من القائمة المنسدلة مباشرة.
بالإضافة إلى ذلك، تم تعيين جسم الطلب، بما في ذلك:
  • image_url: رابط صورة الوجه التي تحتاج إلى معالجتها.
  • face_model_version: إصدار نموذج الخوارزمية المستخدم في خدمة التعرف على الوجه. حاليًا، المدخلات تدعم “3.0”.
بعد الاختيار، يمكنك أن تلاحظ أنه تم إنشاء كود مطابق على الجانب الأيمن، كما هو موضح في الصورة:

انقر على زر “Try” لإجراء الاختبار، كما هو موضح في الصورة أعلاه، هنا حصلنا على النتيجة التالية: 
{
  "score": 0,
  "face_model_version": "3.0"
}
يمكنك أن ترى في هذه المرحلة أننا حصلنا على نتيجة كشف الحيّة الثابتة للوجه، بما في ذلك محتوى درجة الحيّة. توضيح الحقول كما يلي:
  • score: درجة الحيّة، نطاق القيم [0,100]، بناءً على نطاق العتبة المقابل لدرجة الحيّة لتحديد ما إذا كانت صورة معاد تصويرها. حاليًا، يمكن تقسيم العتبات إلى [5,10,40,70,90]، حيث أن العتبة الموصى بها هي 40.
  • face_model_version: إصدار نموذج الخوارزمية المستخدم في التعرف على الوجه.
بالإضافة إلى ذلك، إذا كنت ترغب في توليد كود الدمج المقابل، يمكنك نسخه مباشرة، على سبيل المثال، كود CURL كما يلي: 
curl -X POST 'https://api.acedata.cloud/face/detect-live' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg"
}'
كود الدمج بلغة Python كما يلي: 
import requests

url = "https://api.acedata.cloud/face/detect-live"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
معالجة الأخطاء

عند استدعاء API، إذا واجهت خطأ، ستقوم API بإرجاع رمز الخطأ والمعلومات المناسبة. على سبيل المثال:
  • 400 token_mismatched: طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صالحة.
  • 400 api_not_implemented: طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صالحة.
  • 401 invalid_token: غير مصرح، رمز التفويض غير صالح أو مفقود.
  • 429 too_many_requests: عدد كبير جدًا من الطلبات، لقد تجاوزت الحد المسموح به.
  • 500 api_error: خطأ داخلي في الخادم، حدث خطأ ما على الخادم.

​
مثال على استجابة الخطأ

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
الخاتمة

من خلال هذه الوثيقة، لقد تعرفت على كيفية استخدام كشف الحيّة الثابتة للوجه (الإصدار عالي الدقة) API، والتي يمكن استخدامها للكشف عن الصور الثابتة التي يرفعها المستخدمون لمنع إعادة التصوير، لتحديد ما إذا كانت الصورة المعاد تصويرها. نأمل أن تساعدك هذه الوثيقة في دمج واستخدام API بشكل أفضل. إذا كان لديك أي استفسارات، فلا تتردد في الاتصال بفريق الدعم الفني لدينا.