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

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

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

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

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

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

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

انقر على زر “Try” لإجراء الاختبار، كما هو موضح في الصورة أعلاه، هنا حصلنا على النتيجة التالية: 
{
  "image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/ft/SwapGenderPic/1256437459/1d85ceb9-6847-41ec-a9fd-7a20ddbd13b6"
}
يمكننا أن نرى أن النتيجة التي تم إرجاعها تحتوي على حقل image_url، وهو صورة الوجه التي تم تغييرها بناءً على معلمات تغيير الجنس المدخلة. حيث أن معلومات الوجه بعد التغيير كما هو موضح أدناه:

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

url = "https://api.acedata.cloud/face/change-gender"

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

payload = {
    "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
    "gender_infos": [{"gender":1}]
}

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"
}

​
الخاتمة

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