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

إنشاء نموذج

تتيح لك ميزة إنشاء النموذج (Model Create) إنشاء نماذج أزياء واقعية باستخدام مطالبات بسيطة وبديهية أو صور مرجعية، أو تحميل صور نماذج موجودة إلى مساحة عملك.

اسم النموذج: model-create

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

وقت المعالجة: ~10 ثوانٍ – 30 ثانية (يزداد عند استخدام مراجع متقدمة مثل الوجه/الوضعية)

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

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

الاعتمادات: 1 إلى 5 لكل نموذج (1k: 1، 2k: 3، 4k: 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": "model-create",
           "inputs": {
             "type": "generate",
             "name": "Summer Collection Model",
             "prompt": "Full body shot, woman wearing a white t-shirt and dark blue biker shorts, studio lighting",
             "gender": "female",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

الاستجابة

نظرًا لأن إنشاء النموذج قد يستغرق ما يصل إلى 30 ثانية، فإن نقطة النهاية /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/model-123.png"
  ]
}

معلمات الطلب

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

typeRequired'generate' | 'upload'

يحدد ما إذا كان سيتم إنشاء نموذج جديد عبر الذكاء الاصطناعي (generate) أو تحميل صورة موجودة (upload).

nameRequiredstring

اسم وصفي لنموذجك. يستخدم هذا لتحديد النموذج في الاستوديو الخاص بك.

promptstring

مطلوب للإنشاء وصف نصي للنموذج المراد إنشاؤه. يصف نموذج الأزياء المطلوب، الملابس، الوضعية، ومشهد الخلفية.

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

imageBase64string

مطلوب للتحميل سلسلة صور مشفرة بـ Base64. مطلوبة عندما يتم تعيين type على upload.

متطلبات التنسيق يجب أن تتضمن سلسلة Base64 الخاصة بك بادئة URI للبيانات القياسية (على سبيل المثال، data:image/jpeg;base64,... أو data:image/png;base64,...). سيفشل التحميل إذا تم توفير السلسلة المشفرة الخام فقط.

معلمات الإنشاء الاختيارية

تنطبق هذه المعلمات عندما يتم تعيين type على generate.

genderstring

جنس النموذج. يساعد نموذج الإنشاء في تحديد السمات الجسدية.

bodyTypestring

نوع جسم النموذج (على سبيل المثال، "رياضي"، "مقاس كبير"، "نحيف").

clothingstring

تفاصيل ملابس محددة لفرضها أثناء الإنشاء، مما يعزز prompt الرئيسي.

posestring

وصف نصي للوضعية (على سبيل المثال، "واقفًا ويداه في الجيوب"، "يمشي").

faceModelIdstring

معرف UUID لنموذج وجه موجود لتثبيت هوية محددة عبر الأجيال. سيتكيف الإخراج مع المطالبة المستهدفة مع الحفاظ على الوجه المرجعي.

ملاحظة: توفير مرجع للوجه يضيف عدة ثوانٍ إلى إجمالي وقت المعالجة حيث يقوم الذكاء الاصطناعي بمواءمة الهوية.

poseModelIdstring

معرف UUID لنموذج وضعية موجود. يجبر الإنشاء على مطابقة المرجع بدقة لوضعية الجسم وهيئته.

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

poseImageBase64string

سلسلة صور مشفرة بـ Base64 لاستخدامها كمرجع وضعية مخصص بدلاً من توفير poseModelId محفوظ.

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

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

aspectRatiostring

يحدد نسبة العرض إلى الارتفاع للصورة التي تم إنشاؤها.

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

الافتراضي: 3:4

sampleCountinteger

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

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

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

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

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

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