Arka Plan Değiştirme

Arka Plan Değiştirme uç noktası, bir görüntüdeki konuyu izole etmenize ve metin istemine dayalı olarak tamamen yeni, gerçekçi bir arka plan oluşturmanıza olanak tanır.

Model Adı: background-replace

Yaşam Döngüsü: stable

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

Çıktı Biçimi: Auto (JPEG or PNG)

Teslimat Yöntemleri: URL

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

İstek

Arka plan değiştirme yapılandırmanızı 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": "background-replace",
           "inputs": {
             "subjectImage": "https://example.com/product.jpg",
             "scenePrompt": "Product sitting on a sandy beach during golden hour",
             "quality": "2k"
           }
         }'

Yanıt

Başlangıçtaki izleme nesnesiyle birlikte 201 Created durumu döndürür. Oluşturma eşzamansız olarak çalışır.

{
  "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 (GET uç noktasını yoklayarak), output alanı oluşturulan arka planınıza işaret eden URL'yi 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/bg-replace-123.png"
  ]
}

İstek Parametreleri

Gerekli Parametreler

subjectImageRequiredstring

İzole etmek istediğiniz konuyu içeren görüntü. Herkese açık bir URL veya Base64 kodlu bir görüntü dizesi olabilir. Maksimum boyut: 25MB.

Profesyonel İpucu: Zıt bir arka plana karşı net, keskin kenarları olan konular en temiz kesimleri elde eder. Konunun arka plana karıştığı görüntülerden kaçının (örn. beyaz duvarda beyaz gömlek). Yüksek kontrastlı aydınlatma, yapay zekanın konuyu mükemmel bir şekilde ayırmak için kenar algılamaya güvenmesine yardımcı olur.

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

scenePromptRequiredstring

Konunun arkasında oluşturmak istediğiniz yeni arka plan sahnesinin metinsel açıklaması.

İsteğe Bağlı Parametreler

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

Çıktı çözünürlük katmanı. Nihai oluşturulan görüntünün çözünürlüğünü tanımlar. Varsayılan: 1k

Çalışma Zamanı Hataları

Bu özellik için çalışma zamanı hataları, Hata Yönetimi bölümünde belgelenen paylaşılan kümeyi kullanır. İşleme 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, tamamen seçilen çıktı quality katmanına bağlıdır.

Formül: Maliyet = KaliteKredileri

Kalite Katmanı	Görüntü Başına Kredi
1k (Varsayılan)	1
2k	3
4k	5