حوّل لقطات المنتج المسطحة أو على عارضة أزياء شبحية إلى صور احترافية على نموذج.

المنتج إلى نموذج

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

اسم النموذج: product-to-model

دورة الحياة: مستقر

وقت المعالجة: ~10 ثوانٍ - 30 ثانية (يزداد عند استخدام مراجع الأسلوب أو النموذج)

تنسيق الإخراج: تلقائي (JPEG أو PNG)

طرق التسليم: URL

الاعتمادات: 1 إلى 5 لكل عملية إنشاء (يعتمد على الجودة)

الطلب

أرسل صورة منتجك إلى نقطة النهاية الشاملة /v1/run:

POSThttps://fititon.app/api/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": "product-to-model",
           "inputs": {
             "productImage": "https://example.com/ghost-mannequin-shirt.jpg",
             "styleId": "editorial",
             "customPrompt": "Asian female model, outdoor city street, natural lighting",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "3:4"
           }
         }'

الاستجابة

نظرًا لأن إنشاء الصورة قد يستغرق ما يصل إلى 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 الذي يشير إلى صورتك التي تم إنشاؤها:

{
  "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/product-model-123.png"
  ]
}

معلمات الطلب

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

productImageRequiredstring

صورة المنتج المراد عرضها على نموذج (مسطحة أو على عارضة أزياء شبحية). يمكن أن تكون عنوان URL متاحًا للعامة أو سلسلة صور مشفرة بـ Base64. الحجم الأقصى: 25 ميجابايت.

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

متطلب التنسيق عند إرسال سلسلة Base64، يجب أن تتضمن بادئة URI للبيانات القياسية (على سبيل المثال، data:image/jpeg;base64,...).

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

customPromptstring

تعليمات نصية تصف النموذج المطلوب (مثل الجنس، العرق، الوضعية) أو المشهد. الحد الأقصى للطول: 500 حرف.

modelImageUrlstring

عنوان URL لنموذج مرجعي بشري لاستخدامه في الإنشاء. إذا تم حذفه، سيتم إنشاء نموذج متنوع عشوائي.

النماذج المحددة مسبقًا المتاحة:

ملاحظة: توفير نموذج مرجعي يزيد من وقت المعالجة الإجمالي.

styleIdstring

معرف النمط الفوتوغرافي المراد تطبيقه (على سبيل المثال، "studio"، "iphone"، "editorial"). إذا تم حذفه، يتم تعيين الافتراضي على عرض استوديو محايد.

الأنماط المتاحة:

Style Name	Style ID (`styleId`)

ملاحظة: قد تزيد الأنماط المعقدة من وقت الإنشاء.

quality'1k' | '2k' | '4k'

مستوى دقة الإخراج. 1k ينتج إخراجًا بحوالي 1 ميجابكسل، 2k بحوالي 4 ميجابكسل، و 4k بحوالي 16 ميجابكسل. الافتراضي: 1k

sampleCountinteger

عدد التباينات في الصورة التي سيتم إنشاؤها لكل طلب. يجب أن يكون بين 1 و 4. الافتراضي: 1

ratiostring

يحدد نسبة العرض إلى الارتفاع للصورة التي تم إنشاؤها. إذا كان فارغًا، فإن النظام يضبط الافتراضي على 3:4 لصور الأزياء.

القيم المدعومة: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

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

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

تكلفة الرصيد

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

الصيغة: التكلفة = QualityCredits × sampleCount

مستوى الجودة	الأرصدة لكل صورة
1k (افتراضي)	1
2k	3
4k	5