Düz serim veya hayalet manken ürün çekimlerini profesyonel model üstü fotoğraflara dönüştürün.

Üründen Modele

Üründen Modele uç noktası, düz serim veya hayalet manken ürün çekimlerini profesyonel model üstü fotoğraflara dönüştürerek modelin görünümünü veya fotoğraf stilini belirtmenize olanak tanır.

Model Adı: product-to-model

Yaşam Döngüsü: stable

İşlem Süresi: ~10sn–30sn (stil veya model referansları kullanıldığında artar)

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

Teslimat Yöntemleri: URL

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

İstek

Ürün görselinizi 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": "product-to-model",
           "inputs": {
             "productImage": "https://example.com/ghost-mannequin-shirt.jpg",
             "styleId": "editorial",
             "customPrompt": "Asian female model, outdoor city street, natural lighting",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "3:4"
           }
         }'

Yanıt

Görsel oluşturma 20 saniyeye kadar sürebileceğinden, /v1/run uç noktası eşzamansız bir iş id'si ile hemen 201 Created durumu döndürür. Nihai sonuçları almak için Durum API'sini GET /v1/status/{id} kullanarak sorgulamanız gerekir. Alternatif olarak, bildirimleri otomatik olarak almak için webhook'ları yapılandırabilirsiniz. Webhook göndericimizin katı bir 15 saniyelik zaman aşımı uyguladığını lütfen unutmayın. Sunucunuz, 15 saniye içinde webhook'u bir 2xx durum koduyla onaylamalıdır, aksi takdirde başarısız sayılacak ve daha sonra tekrar denenecektir.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

Durum "succeeded" olarak değiştiğinde, output alanı oluşturulan görselin URL'sini içeren bir dizi içerecektir:

{
  "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/product-model-123.png"
  ]
}

İstek Parametreleri

Zorunlu Parametreler

productImageRequiredstring

Bir model üzerine giydirilecek ürün görseli (düz serim veya hayalet manken). Herkese açık bir URL veya Base64 kodlu bir görsel dizesi olabilir. Maksimum boyut: 25MB.

Profesyonel İpucu: Beyaz arka plan üzerindeki düz serim fotoğraflar, model üstü sonuçlarda en tutarlı sonuçları verir. Manken fotoğrafları da iyi çalışır. Çekimden önce etiketi, fiyat etiketlerini veya giysinin parçası olmayan aksesuarları çıkarın. Giysinin tamamının görünür ve katlanmamış olduğundan emin olun — kesik kol olmamalıdır.

Biçimlendirme Gereksinimi Bir Base64 dizesi gönderirken, standart veri URI önekini (örn. data:image/jpeg;base64,...) içermelidir.

İsteğe Bağlı Parametreler

customPromptstring

İstenen modeli (örn. cinsiyet, etnik köken, poz) veya sahneyi açıklayan metinsel talimatlar. Maksimum uzunluk: 500 karakter.

modelImageUrlstring

Oluşturma için kullanılacak bir insan referans modelinin URL'si. Atlanırsa, rastgele çeşitli bir model oluşturulacaktır.

Hazır Modeller Mevcut:

Not: Bir referans model sağlamak, genel işlem süresini artırır.

styleIdstring

Uygulanacak fotoğraf stili kimliği (örn. "studio", "iphone", "editorial"). Atlanırsa, varsayılan olarak nötr bir stüdyo sunumu kullanılır.

Mevcut Stiller:

Style Name	Style ID (`styleId`)

Not: Karmaşık stiller oluşturma süresini artırabilir.

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

Çıktı çözünürlük katmanı. 1k ~1 megapiksel çıktı, 2k ~4 megapiksel ve 4k ~16 megapiksel üretir. 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

Oluşturulan görselin genişlik-yükseklik oranını tanımlar. Boş bırakılırsa, sistem moda çekimleri için varsayılan olarak 3:4 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ümesi kullanır. İşlem sırasında bir hata oluşursa, status "error" olarak güncellenecek ve error alanı belirli hata nedenini içerecektir.

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)	1
2k	3
4k	5