Görsel referanslar kullanarak yapay zeka moda modelleri üzerinde giysileri sorunsuz bir şekilde değiştirin.

Sanal Deneme (Görselle Deneme)

Deneme uç noktası, bir görsel referansı kullanarak bir giysiyi bir kişinin üzerine sorunsuz bir şekilde giydirmenizi sağlar.

Model Adı: tryon

Yaşam Döngüsü: stable

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

Çıktı Formatı: Auto (JPEG or PNG)

Teslimat Yöntemleri: URL (via Polling)

Krediler: 1 × sampleCount

İstek

Deneme yapılandırmanızı evrensel /v1/run uç noktasına bir JSON yükü kullanarak 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": "tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "garmentImage": "https://example.com/garment.jpg",
             "accuracy": "high",
             "sampleCount": 1
           }
         }'

Yanıt

Deneme oluşturma işlemi arka planda eşzamansız olarak gerçekleşir. İsteğiniz, bir takip nesnesiyle birlikte hemen bir 200 OK durumu döndürecektir.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

Sonuçlar İçin Yoklama Oluşturulan görsel URL'lerinizi almak için döndürülen id'yi kullanarak durum uç noktasını (GET https://fititon.app/api/v1/status/{id}) yoklamanız gerekir. Ayrıntılı talimatlar için API Kurulumu kılavuzuna bakın.

İstek Parametreleri

Gerekli Parametreler

personImageRequiredstring

Giydirmek istediğiniz modelin temel görseli. Herkese açık bir URL veya Base64 kodlu bir görsel dizesi olabilir. Desteklenen formatlar: JPEG, PNG, WEBP. Maksimum boyut: 25MB.

Profesyonel İpucu: Kolları görünür olan öne dönük pozlar en gerçekçi giydirmeyi sağlar. Çekimden önce vücudu kapatan çantaları, eşarpları veya ceketleri çıkarın.

Biçimlendirme Gereksinimi Bir Base64 dizesi gönderirken, standart veri URI önekini (örn. data:image/jpeg;base64,...) içermelidir. /v1/run uç noktası yalnızca JSON yüklerini kabul eder, bu nedenle multipart/form-data yüklemeleri desteklenmez.

garmentImageRequiredstring

Denenecek giyim eşyasının görseli. Herkese açık bir URL veya Base64 kodlu bir görsel dizesi olabilir.

Profesyonel İpucu: Beyaz arka plan üzerindeki düz serilmiş giysi fotoğrafları, askıdaki çekimlerden veya buruşuk giysilerden gözle görülür şekilde daha iyi sonuç verir.

İsteğe Bağlı Parametreler

accuracy'standard' | 'high' | 'hyper'

Deneme uyumunun doğruluğunu tanımlar. Daha yüksek doğruluk, oluşturma hassasiyetini artırır ancak biraz daha uzun sürebilir. Varsayılan: standard

sampleCountinteger

İstek başına oluşturulacak görsel varyasyonlarının sayısı. 1 ile 4 arasında olmalıdır. Ek görseller daha fazla kredi tüketir ve işlem süresini doğrusal olarak artırır. Varsayılan: 1

Ç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. İşlem 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 Sanal Deneme uç noktası, talep edilen quality seviyesinden bağımsız olarak, oluşturulan görsel başına 1 kredi sabit ücretle çalışır.

Formül: Cost = 1 × sampleCount

Parametre	Görsel Başına Kredi
Sabit Ücret	1