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

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

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

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

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

ثم نحتاج أيضًا إلى رفع معلومات معلمات تحسين الوجه، التفاصيل موجودة في معلومات جسم الطلب أدناه. بعد ذلك، يمكننا ملء المحتوى المناسب في الواجهة، كما هو موضح في الصورة:

يمكننا أن نرى هنا أننا قمنا بتعيين رؤوس الطلب، بما في ذلك:
  • accept: نوع الاستجابة التي ترغب في تلقيها، هنا يتم ملؤها بـ application/json، أي بتنسيق JSON.
  • authorization: مفتاح استدعاء واجهة برمجة التطبيقات، بعد التقديم يمكنك اختيارها مباشرة من القائمة المنسدلة.
بالإضافة إلى ذلك، تم تعيين جسم الطلب، بما في ذلك:
  • image_url: رابط صورة الوجه التي تحتاج إلى معالجتها.
  • smoothing: درجة تنعيم البشرة، نطاق القيم [0,100]. 0 يعني عدم التنعيم، و100 تمثل أعلى درجة. القيمة الافتراضية 10.
  • whitening: درجة تفتيح البشرة، نطاق القيم [0,100]. 0 يعني عدم التفتيح، و100 تمثل أعلى درجة. القيمة الافتراضية 30.
  • face_lifting: درجة تصغير الوجه، نطاق القيم [0,100]. 0 يعني عدم التصغير، و100 تمثل أعلى درجة. القيمة الافتراضية 70.
  • eye_enlarging: درجة تكبير العين، نطاق القيم [0,100]. 0 يعني عدم التكبير، و100 تمثل أعلى درجة. القيمة الافتراضية 70.
بعد الاختيار، يمكن ملاحظة أنه تم توليد الكود المقابل على الجانب الأيمن، كما هو موضح في الصورة:

انقر على زر “Try” لإجراء الاختبار، كما هو موضح في الصورة أعلاه، هنا حصلنا على النتيجة التالية: 
{
  "image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/fmu/BeautifyPic/1256437459/1a68c13b-b03c-4c7b-92a1-e4a9b5f1d7ec"
}
يمكننا أن نرى أن النتيجة التي تم إرجاعها تحتوي على حقل image_url، وهو صورة الوجه بعد التغييرات الناتجة عن تحسين الوجه المدخل. حيث أن معلومات الوجه بعد التغيير كما هو موضح أدناه:

يمكننا أن نرى أن الوجه في الصورة قد تغير بناءً على معلومات تحسين الوجه المدخلة. بالإضافة إلى ذلك، إذا كنت ترغب في توليد الكود المقابل، يمكنك نسخه مباشرة، على سبيل المثال، كود CURL كما يلي: 
curl -X POST 'https://api.acedata.cloud/face/beautify' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
  "smoothing": 50,
  "whitening": 50,
  "face_lifting": 50,
  "eye_enlarging": 50
}'
كود الربط بلغة Python كما يلي: 
import requests

url = "https://api.acedata.cloud/face/beautify"

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

payload = {
    "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
    "smoothing": 50,
    "whitening": 50,
    "face_lifting": 50,
    "eye_enlarging": 50
}

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

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

عند استدعاء واجهة برمجة التطبيقات، إذا واجهت خطأ، ستقوم واجهة برمجة التطبيقات بإرجاع رمز الخطأ والمعلومات المناسبة. على سبيل المثال:
  • 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"
}

​
الخاتمة

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