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

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

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

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

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

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

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

انقر على زر “Try” لإجراء الاختبار، كما هو موضح في الصورة أعلاه، وهنا حصلنا على النتيجة التالية: 
{
  "image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/ft/ChangeAgePic/1256437459/bfce1ab8-5fd7-464d-8878-b38433f84d0e"
}
يمكنك أن ترى أن النتيجة التي تم إرجاعها تحتوي على حقل image_url، وهو صورة الوجه التي تغيرت بناءً على العمر المدخل. حيث أن معلومات الوجه بعد التغيير كما هو موضح أدناه:

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

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

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

payload = {
    "age_infos": [{"age":60}],
    "image_url": "https://cdn.acedata.cloud/f5687u.png"
}

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

​
الخاتمة

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