تطبيق تأثيرات وقوالب إبداعية عالية الأناقة على صور الأزياء لوسائل التواصل الاجتماعي.

استوديو التواصل الاجتماعي

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

اسم النموذج: social-studio

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

وقت المعالجة: ~15s–30s

تنسيق الإخراج: Auto (JPEG or PNG)

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

الاعتمادات: 2 إلى 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": "social-studio",
           "inputs": {
             "personImage": "https://example.com/model-shot.jpg",
             "styleId": "action-figure",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

الاستجابة

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

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "social-studio"
}

عند اكتمال المهمة (status: "success"), سيحتوي حقل output على مصفوفة من عناوين URL الناتجة:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/social-studio-123-0.png"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

معلمات الطلب

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

personImageRequiredstring

الصورة المصدر لتطبيق النمط عليها. يمكن أن تكون عنوان URL متاحًا للعامة أو سلسلة صور مشفرة بـ Base64.

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

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

styleIdRequiredstring

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

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

Style Name	Style ID (`styleId`)

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

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

مستوى دقة الإخراج. الافتراضي: 1k

sampleCountinteger

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

ratiostring

تجاوز نسبة العرض إلى الارتفاع. إذا كان فارغًا، فإن النظام يعتمد افتراضيًا على 1:1 (مثالي لخلاصات Instagram/الشبكات الاجتماعية).

القيم المدعومة: '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.

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

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