Moda şəkillərinə sosial media üçün yüksək stilizə edilmiş yaradıcı effektlər və şablonlar tətbiq edin.

Sosial Studiya

Sosial Studiya endpointi moda şəkillərinizə yüksək stilizə edilmiş, yaradıcı estetik şablonlar tətbiq edərək onları sosial media marketinqi üçün mükəmməl uyğun gələn cəlbedici məzmuna çevirir.

Model Adı: social-studio

Həyat Dövrü: stable

Emal Vaxtı: ~15s–30s

Çıxış Formatı: Auto (JPEG or PNG)

Çatdırılma Metodları: URL

Kreditlər: 2 to 5 hər nəsil üçün (keyfiyyətdən asılıdır)

Sorğu

Şəklinizi və seçilmiş stil ID-nizi universal /v1/run endpointinə göndərin:

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

Sorğu Nümunələri

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
           }
         }'

Cavab

Şəkil generasiyası 30 saniyəyə qədər çəkə bildiyi üçün, /v1/run endpointi dərhal asinxron iş id ilə 201 Created statusunu qaytarır. Son şəkli əldə etmək üçün bu id istifadə edərək Status API-ni sorğulamalısınız. Alternativ olaraq, bildirişləri avtomatik almaq üçün veb-hookları konfiqurasiya edə bilərsiniz. Nəzərə alın ki, veb-hook göndəricimiz ciddi 15 saniyəlik vaxt aşımı tətbiq edir. Serveriniz veb-hooku 15 saniyə ərzində 2xx status kodu ilə təsdiq etməlidir, əks halda biz onu uğursuz hesab edib daha sonra yenidən cəhd edəcəyik.

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

İş tamamlandıqda (status: "success"), output sahəsi nəticədə yaranan URL-lərin massivini ehtiva edəcək:

{
  "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"
}

Sorğu Parametrləri

Tələb Olunan Parametrlər

personImageRequiredstring

Stilizə ediləcək mənbə şəkli. Ümumi əlçatan URL və ya Base64 ilə kodlanmış şəkil sətiri ola bilər.

Peşəkar Məsləhət: Bütün şəxsin göründüyü tam bədən şəkilləri ən yaxşı stilizə edilmiş nəticələr verir. Üzün aydın görünməsi vacibdir — süni intellekt stilizə edilmiş versiyanızı yaratmaq üçün üz xüsusiyyətlərindən istifadə edir. Qrup şəkillərindən və ya obyektlərin arxasında qismən gizləndiyiniz şəkillərdən çəkinin.

Formatlaşdırma Tələbi Base64 sətiri göndərərkən, o, standart məlumat URI prefiksini (məsələn, data:image/jpeg;base64,...) ehtiva etməlidir. personImage Base64 sətirlərini qəbul etsə də, sorğunuzda qlobal JSON yük ölçüsü limitlərinə (HTTP 413) çatmaması üçün 3MB-dan böyük şəkillər üçün standart HTTP URL-lərindən istifadə etməyi şiddətlə tövsiyə edirik.

styleIdRequiredstring

Yaradılan şəkilə tətbiq ediləcək fotoqrafik stil ID-si. Bu, işıqlandırmanı, estetik görünüşü və əhval-ruhiyyəni müəyyən edir.

Mövcud Stillər:

Style Name	Style ID (`styleId`)

Könüllü Parametrlər

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

Çıxış qətnamə səviyyəsi. Defolt: 1k

sampleCountinteger

Hər sorğu üçün yaradılacaq şəkil variasiyalarının sayı. 1 ilə 4 arasında olmalıdır. Defolt: 1

ratiostring

Tərəf nisbəti üzərində dəyişiklik. Boş olarsa, sistem defolt olaraq 1:1 (Instagram/sosial lentlər üçün ideal) təyin edir.

Dəstəklənən dəyərlər: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

İşləmə Zamanı Xətalar

Bu funksiya üçün işləmə zamanı xətalar Xəta İdarəetməsi sənədlərində qeyd olunan ümumi dəstdən istifadə edir. Emal zamanı xəta baş verərsə, status "error" olaraq yenilənəcək və error sahəsi xətanın xüsusi səbəbini ehtiva edəcək.

Kredit Dəyəri

Tərtibatçı API sorğuları üçün dəyər seçilmiş çıxış quality səviyyəsinin sampleCount ilə vurulmasından asılıdır.

Formula: Cost = QualityCredits × sampleCount

Keyfiyyət Səviyyəsi	Şəkil Başına Kreditlər
1k (Defolt)	2
2k	3
4k	5