الانتقال إلى المحتوى الرئيسي

مقدمة

Face Change هي خدمة صور بالذكاء الاصطناعي تقدمها Ace Data Cloud، وهي خدمة معالجة وجوه بالذكاء الاصطناعي. من خلال واجهة برمجة التطبيقات الموحدة لـ Ace Data Cloud، يمكنك دمج Face Change بسرعة باستخدام بايثون لتحقيق وظائف مثل استبدال الوجه، تحسين الوجه، تغيير العمر، تغيير الجنس، التحويل إلى رسوم متحركة، وتحليل الوجه.

المتطلبات المسبقة

  • امتلاك حساب على Ace Data Cloud والحصول على رمز API Token
  • بيئة بايثون 3.7 أو أحدث
  • تثبيت مكتبة requests: pip install requests

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

النقطة النهائية الرئيسية لاستدعاء API الخاص بـ Face Change هي:
POST https://api.acedata.cloud/face/swap
مثال كامل على كود بايثون:
import requests

url = "https://api.acedata.cloud/face/swap"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "source_image_url": "https://example.com/source-face.jpg",
    "target_image_url": "https://example.com/target-face.jpg"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
يرجى استبدال YOUR_API_TOKEN بالرمز الفعلي الذي حصلت عليه من منصة Ace Data Cloud.

معالجة الاستجابة

بعد الاستدعاء الناجح، تعيد API بيانات بصيغة JSON. يُنصح بالتحقق من رمز الحالة HTTP:
if response.status_code == 200:
    result = response.json()
    print("تم الاستدعاء بنجاح:", result)
else:
    print(f"فشل الاستدعاء، رمز الحالة: {response.status_code}")
    print(response.text)

الاستخدام المتقدم

بالنسبة للـ API التي تدعم المهام غير المتزامنة، يمكن الحصول على النتائج عبر عنوان URL للنداء العكسي (callback):
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# سيتم إرسال النتائج إلى خادمك عبر عنوان URL للنداء العكسي

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

رموز الأخطاء الشائعة:
رمز الحالةالوصف
401فشل التوثيق، يرجى التحقق من API Token
403رصيد غير كافٍ أو لا توجد صلاحية وصول
429تجاوز معدل الطلبات المسموح به
500خطأ داخلي في الخادم

نقاط نهاية أخرى

توفر خدمة Face Change أيضًا النقاط النهائية التالية:
  • POST https://api.acedata.cloud/face/beautify
  • POST https://api.acedata.cloud/face/change-age
  • POST https://api.acedata.cloud/face/change-gender
  • POST https://api.acedata.cloud/face/cartoon
  • POST https://api.acedata.cloud/face/analyze

الخطوة التالية