Logo

Social Studio

Sosyal medya için moda görsellerine yüksek stilize edilmiş yaratıcı efektler ve şablonlar uygulayın.

Social Studio

Social Studio uç noktası, moda görsellerinize yüksek stilize edilmiş, yaratıcı estetik şablonlar uygulayarak onları sosyal medya pazarlaması için mükemmel, dikkat çekici içeriğe dönüştürür.

Model Adı: social-studio

Yaşam Döngüsü: stable

İşlem Süresi: ~15s–30s

Çıktı Formatı: Otomatik (JPEG veya PNG)

Teslimat Yöntemleri: URL

Krediler: Nesil başına 2 ila 5 (kaliteye bağlıdır)

İstek

Görselinizi ve seçtiğiniz stil kimliğini evrensel /v1/run uç noktasına gönderin:

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

İstek Örnekleri

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

Yanıt

Görsel oluşturma 30 saniyeye kadar sürebileceğinden, /v1/run uç noktası hemen 201 Created durumunu ve eşzamansız bir iş id'sini döndürür. Nihai görseli almak için bu id'yi kullanarak Durum API'sini sorgulamanız gerekir. Alternatif olarak, bildirimleri otomatik olarak almak için web kancalarını yapılandırabilirsiniz. Web kancası göndericimizin katı bir 15 saniyelik zaman aşımı uyguladığını lütfen unutmayın. Sunucunuz, web kancasını 15 saniye içinde 2xx durum koduyla onaylamalıdır, aksi takdirde başarısız sayılır ve daha sonra tekrar denenir.

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

İş tamamlandığında (status: "success"), output alanı sonuç URL'lerinin bir dizisini içerecektir:

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

İstek Parametreleri

Gerekli Parametreler

personImageRequiredstring

Stilize edilecek kaynak görsel. Herkese açık bir URL veya Base64 kodlu bir görsel dizesi olabilir.

Profesyonel İpucu: Tüm kişinin göründüğü tam vücut fotoğrafları en iyi stilize edilmiş sonuçları verir. Yüzün net görünürlüğü önemlidir — yapay zeka, stilize edilmiş versiyonunuzu oluşturmak için yüz özelliklerini kullanır. Grup fotoğraflarından veya nesnelerin arkasında kısmen gizlendiğiniz görsellerden kaçının.

Biçimlendirme Gereksinimi Bir Base64 dizesi gönderirken, standart veri URI önekini (örn. data:image/jpeg;base64,...) içermelidir. personImage Base64 dizelerini kabul etse de, isteğinizdeki genel JSON yük boyutu sınırlarına (HTTP 413) takılmamak için 3MB'den büyük görseller için standart HTTP URL'lerini kullanmanızı şiddetle tavsiye ederiz.

styleIdRequiredstring

Oluşturulan görsele uygulanacak fotoğrafik stil kimliği. Bu, aydınlatmayı, estetiği ve ruh halini belirler.

Mevcut Stiller:

Style NameStyle ID (`styleId`)

İsteğe Bağlı Parametreler

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

Çıktı çözünürlük katmanı. Varsayılan: 1k

sampleCountinteger

İstek başına oluşturulacak görsel varyasyonlarının sayısı. 1 ile 4 arasında olmalıdır. Varsayılan: 1

ratiostring

En boy oranı geçersiz kılma. Boş bırakılırsa, sistem varsayılan olarak 1:1 (Instagram/sosyal akışlar için ideal) oranını kullanır.

Desteklenen değerler: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

Çalışma Zamanı Hataları

Bu özellik için çalışma zamanı hataları, Hata Yönetimi bölümünde belgelenen ortak küme kullanılır. İşleme sırasında bir hata oluşursa, status "error" olarak güncellenir ve error alanı belirli hata nedenini içerir.

Kredi Maliyeti

Geliştirici API istekleri için maliyet, seçilen çıktı quality katmanının sampleCount ile çarpılmasına bağlıdır.

Formül: Maliyet = KaliteKredileri × örnekSayısı

Kalite KatmanıGörsel Başına Kredi
1k (Varsayılan)2
2k3
4k5