صف زيًا جديدًا باستخدام النص لتطبيقه بسلاسة على نماذج أزياء الذكاء الاصطناعي.

تجربة الملابس بالوصف النصي

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

اسم النموذج: prompt-tryon

دورة الحياة: stable

وقت المعالجة: ~15s–40s (يزداد عند استخدام مراجع الأنماط أو النماذج)

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

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

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

الطلب

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

POSThttps://fititon.app/api/v1/run

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

المصادقة يمكنك تمرير مفتاح API الخاص بك إما كرمز مميز من نوع Bearer (Authorization: Bearer YOUR_API_KEY) أو عبر رأس x-api-key (x-api-key: YOUR_API_KEY).

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "prompt-tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "prompt": "A stylish red summer dress with floral patterns.",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "16:9",
             "modelImageUrl": "https://example.com/model-reference.jpg",
             "styleId": "movie"
           }
         }'

الاستجابة

يتم توليد تجربة الملابس بشكل غير متزامن في الخلفية. سيعيد طلبك فورًا حالة 200 OK مع كائن تتبع.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

استقصاء النتائج يجب عليك استخدام id المُعاد لاستقصاء نقطة نهاية الحالة (GET https://fititon.app/api/v1/status/{id}) لاسترداد عناوين URL للصور التي تم إنشاؤها. راجع دليل إعداد واجهة برمجة التطبيقات للحصول على تعليمات مفصلة.

عند انتهاء عملية التوليد، ستعيد نقطة نهاية الاستقصاء status: "success" مع مصفوفة output التالية التي تحتوي على عناوين URL للصور النهائية:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://pub-r2.com/.../result-0.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00Z",
  "updated_at": "2026-07-17T11:00:45Z"
}

معلمات الطلب

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

personImageRequiredstring

الصورة الأساسية للنموذج الذي تريد إلباسه. يمكن أن تكون عنوان URL متاحًا للعامة أو سلسلة صور مشفرة بـ Base64. التنسيقات المدعومة: JPEG، PNG، WEBP. الحجم الأقصى: 25 ميجابايت.

نصيحة احترافية: الوضعيات الأمامية مع الأذرع المرئية تنتج أكثر التطبيقات واقعية.

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

promptRequiredstring

وصف نصي للزي الذي تريد أن يرتديه النموذج.

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

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

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

مستوى دقة الإخراج لتجربة الملابس بالوصف النصي (نماذج Gemini). تستهلك الدقة الأعلى المزيد من الاعتمادات. الافتراضي: 1k

sampleCountinteger

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

ratiostring

يحدد نسبة العرض إلى الارتفاع للصورة التي تم إنشاؤها. إذا كان فارغًا، فإن النظام يستخدم نسبة العرض إلى الارتفاع للصورة personImage افتراضيًا.

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

modelImageUrlstring

اختياري. عنوان URL لنموذج مرجعي بشري لاستخدامه بدلاً من الحفاظ على ميزات الشخص الأصلي.

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

styleIdstring

اختياري. تطبيق نمط تصوير فوتوغرافي محدد على الصورة الناتجة.

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

Style Name	Style ID (`styleId`)

القيم الصالحة: y2k, studio, iphone, professional, lifestyle, analog, streetwear, flash, movie, minimalist, ugc, editorial.

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

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

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

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

تعتمد التكلفة على مستوى quality المحدد وتُضرب في sampleCount الخاص بك.

الصيغة: Cost = QualityCredits × sampleCount

المعلمة	الاعتمادات لكل صورة
`quality="1k"`	1
`quality="2k"`	3
`quality="4k"`	5