توليد الزوايا

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

الطلب

أرسل صورتك والزوايا المطلوبة إلى نقطة النهاية الشاملة /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": "angle-generation",
           "inputs": {
             "imageUrl": "https://example.com/front-view.jpg",
             "angleIds": ["back", "leftSide"],
             "quality": "2k"
           }
         }'

الاستجابة

نظرًا لأن توليد الزوايا قد يستغرق ما يصل إلى 20 ثانية، فإن نقطة النهاية /v1/run تُرجع حالة 201 Created فورًا مع معرف مهمة غير متزامن (id). يجب عليك استقصاء واجهة برمجة تطبيقات الحالة باستخدام GET /v1/status/{id} لاسترداد النتائج النهائية. بدلاً من ذلك، يمكنك تكوين webhooks لتلقي الإشعارات تلقائيًا. يرجى ملاحظة أن مرسل الـ webhook الخاص بنا يفرض مهلة صارمة تبلغ 15 ثانية. يجب أن يؤكد خادمك الـ webhook برمز حالة 2xx في غضون 15 ثانية، وإلا سنعتبره فاشلاً ونعيد المحاولة لاحقًا.

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

بمجرد أن تتغير status إلى "succeeded"، سيحتوي حقل output على مصفوفة من عناوين URL التي تشير إلى صورك التي تم إنشاؤها. يتم إرجاع الصور بنفس الترتيب تمامًا مثل مصفوفة angleIds المقدمة في طلبك الأولي:

{
  "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/angle-123-0.png",
    "https://cdn.fititon.app/users/123/results/angle-123-1.png"
  ]
}

معلمات الطلب

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

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

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

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

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

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

الصيغة: التكلفة = اعتمادات_الجودة × عدد_الزوايا

مثال: طلب ["back", "leftSide", "rightSide"] بجودة 1k يكلف 3 اعتمادات إجمالاً. طلب نفس الزوايا الثلاث بجودة 4k يكلف 15 اعتمادًا إجمالاً.