التحكم في الوضعية

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

الطلب

أرسل صورة العارضة الخاصة بك وقائمة بالوضعيات المطلوبة إلى نقطة النهاية الشاملة /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": "pose-control",
           "inputs": {
             "modelImage": "https://example.com/model-standing.jpg",
             "quality": "2k",
             "poses": [
               {
                 "type": "template",
                 "cdnUrl": "https://example.com/pose-reference.jpg",
                 "title": "Hands on hips"
               },
               {
                 "type": "custom",
                 "text": "Sitting on a chair with legs crossed"
               }
             ]
           }
         }'

الاستجابة

نظرًا لأن عملية الإنشاء قد تستغرق ما يصل إلى 30 ثانية، فإن نقطة النهاية /v1/run تُرجع حالة 201 Created فورًا مع id لوظيفة غير متزامنة. يجب عليك استقصاء واجهة برمجة تطبيقات الحالة (Status API) باستخدام GET /v1/status/{id} لاسترداد النتائج النهائية. بدلاً من ذلك، يمكنك تكوين webhooks لتلقي الإشعارات تلقائيًا. يرجى ملاحظة أن مرسل الويب هوك الخاص بنا يفرض مهلة صارمة تبلغ 15 ثانية. يجب أن يؤكد الخادم الخاص بك الويب هوك برمز حالة 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 تشير إلى الصور التي تم إنشاؤها. يتم إرجاع الصور بنفس الترتيب تمامًا مثل مصفوفة poses المقدمة في طلبك الأولي:

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

معلمات الطلب

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

قوالب الوضعيات الرسمية

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

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

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

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

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

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

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

مثال: طلب مصفوفة من 3 وضعيات بجودة 1k يكلف 3 اعتمادات إجمالاً. طلب نفس 3 وضعيات بجودة 4k يكلف 15 اعتمادًا إجمالاً.