استبدال الخلفية

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

الطلب

أرسل إعدادات استبدال الخلفية الخاصة بك إلى نقطة النهاية الشاملة /v1/run:

أمثلة الطلبات

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "background-replace",
           "inputs": {
             "subjectImage": "https://example.com/product.jpg",
             "scenePrompt": "Product sitting on a sandy beach during golden hour",
             "quality": "2k"
           }
         }'

الاستجابة

يعيد حالة 201 Created مع كائن التتبع الأولي. يتم تشغيل عملية الإنشاء بشكل غير متزامن.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

بمجرد أن تتغير status إلى "succeeded" (عبر استقصاء نقطة نهاية GET)، سيحتوي حقل output على مصفوفة تحتوي على عنوان URL الذي يشير إلى الخلفية التي تم إنشاؤها:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "succeeded",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": [
    "https://cdn.fititon.app/users/123/results/bg-replace-123.png"
  ]
}

معلمات الطلب

المعلمات المطلوبة

المعلمات الاختيارية

أخطاء وقت التشغيل

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

تكلفة الاعتمادات

بالنسبة لطلبات واجهة برمجة تطبيقات المطورين، تعتمد التكلفة بالكامل على مستوى quality المختار للإخراج.

الصيغة: Cost = QualityCredits