Yapay zeka moda modelleri üzerine giydirmek için yeni bir kıyafeti metin kullanarak tanımlayın.

Metinle Deneme

Metinle Deneme uç noktası, yapay zeka moda modelleri üzerine sorunsuz bir şekilde giydirmek için yeni bir kıyafeti metin kullanarak tanımlamanıza olanak tanır.

Model Adı: prompt-tryon

Yaşam Döngüsü: stable

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

Çıktı Biçimi: Otomatik (JPEG veya PNG)

Teslimat Yöntemleri: URL

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

İstek

Deneme yapılandırmanızı evrensel /v1/run uç noktasına gönderin:

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

İstek Örnekleri

Kimlik Doğrulama API anahtarınızı bir Bearer token olarak (Authorization: Bearer YOUR_API_KEY) veya x-api-key başlığı aracılığıyla (x-api-key: YOUR_API_KEY) iletebilirsiniz.

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "prompt-tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "prompt": "A stylish red summer dress with floral patterns.",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "16:9",
             "modelImageUrl": "https://example.com/model-reference.jpg",
             "styleId": "movie"
           }
         }'

Yanıt

Deneme üretimi arka planda eşzamansız olarak gerçekleşir. İsteğiniz hemen bir takip nesnesiyle birlikte 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.

Üretim tamamlandığında, yoklama uç noktası, nihai görsel URL'lerini içeren aşağıdaki output dizisiyle birlikte status: "success" döndürecektir:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://pub-r2.com/.../result-0.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00Z",
  "updated_at": "2026-07-17T11:00:45Z"
}

İstek Parametreleri

Gerekli Parametreler

personImageRequiredstring

Giydirmek istediğiniz modelin temel görüntüsü. Herkese açık bir URL veya Base64 kodlu bir görüntü 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.

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.

promptRequiredstring

Modelin giymesini istediğiniz kıyafetin metin açıklaması.

Profesyonel İpucu: En iyi sonuçlar için kumaş türünü (ipek, pamuk, kot) ve kalıp stilini (dar, bol) ekleyin. Renkleri hassas bir şekilde belirtin ("lacivert", "mavi"den daha iyi çalışır) ve yapay zekanın tam olarak neyi değiştireceğini bilmesi için modelin zaten ne giydiğine açıkça atıfta bulunun.

İsteğe Bağlı Parametreler

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

Metinle Deneme (Gemini modelleri) için çıktı çözünürlük katmanı. Daha yüksek çözünürlükler daha fazla kredi tüketir. Varsayılan: 1k

sampleCountinteger

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

ratiostring

Oluşturulan görüntünün genişlik-yükseklik oranını tanımlar. Boş bırakılırsa, sistem personImage'ın en boy oranını varsayılan olarak 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'.

modelImageUrlstring

İsteğe bağlı. Orijinal kişinin özelliklerini korumak yerine kullanılacak bir insan referans modelinin URL'si.

Mevcut Ön Ayarlı Modeller:

styleIdstring

İsteğe bağlı. Çıktı görüntüsüne belirli bir fotoğraf stili uygulayın.

Mevcut Stiller:

Style Name	Style ID (`styleId`)

Geçerli değerler: y2k, studio, iphone, professional, lifestyle, analog, streetwear, flash, movie, minimalist, ugc, editorial.

Not: Karmaşık stiller, genel üretim süresini artırabilir.

Ç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. İşlem sırasında bir hata oluşursa, status "error" olarak güncellenecek ve error alanı belirli hata nedenini içerecektir.

Kredi Maliyeti

Maliyet, seçilen quality katmanına bağlıdır ve sampleCount değerinizle çarpılır.

Formül: Maliyet = QualityCredits × sampleCount

Parametre	Görüntü Başına Kredi
`quality="1k"`	1
`quality="2k"`	3
`quality="4k"`	5