Referans görselleri veya açıklayıcı metin istemleri kullanarak moda modellerini tam duruşlara yeniden konumlandırın.

Poz Kontrolü

Poz Kontrolü uç noktası, bir modelin mevcut bir görüntüsünü alarak, modelin farklı bir vücut pozu aldığı yeni varyasyonlar oluşturmanıza olanak tanır. Yapay zeka, modelin yüz özelliklerini, kıyafetlerini ve arka planını titizlikle korur.

Model Adı: pose-control

Yaşam Döngüsü: stable

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

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

Teslimat Yöntemleri: URL

Krediler: 1 to 5 per pose generated (1k: 1, 2k: 3, 4k: 5)

İstek

Model görselinizi ve istenen pozların bir listesini evrensel /v1/run uç noktasına gönderin:

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

İstek Örnekleri

Bir modeli referans görsel (şablon) veya metin açıklaması (özel) kullanarak yeniden konumlandırabilirsiniz.

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "pose-control",
           "inputs": {
             "modelImage": "https://example.com/model-standing.jpg",
             "quality": "2k",
             "poses": [
               {
                 "type": "template",
                 "cdnUrl": "https://example.com/pose-reference.jpg",
                 "title": "Eller belde"
               },
               {
                 "type": "custom",
                 "text": "Bacak bacak üstüne atmış bir sandalyede oturuyor"
               }
             ]
           }
         }'

Yanıt

Oluşturma işlemi 30 saniyeye kadar sürebileceğinden, /v1/run uç noktası hemen eşzamansız bir iş id'si ile 201 Created durumunu döndürür. Nihai sonuçları almak için GET /v1/status/{id} kullanarak Durum API'sini 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, webhook'u 15 saniye içinde 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örsellerinize işaret eden URL'lerden oluşan bir dizi içerecektir. Görseller, ilk isteğinizde sağlanan poses dizisiyle tamamen aynı sırada döndürülür:

{
  "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/fititon-pose-123-0.png",
    "https://cdn.fititon.app/users/123/results/fititon-pose-123-1.png"
  ]
}

İstek Parametreleri

Gerekli Parametreler

modelImageRequiredstring

Yeniden konumlandırmak istediğiniz kişinin kaynak görüntüsü. Herkese açık bir URL veya Base64 kodlu bir görüntü dizesi olabilir.

Profesyonel İpucu: Baştan ayağa tam vücut fotoğrafları en iyi sonuçları verir — yapay zekanın vücudu doğru bir şekilde yeniden konumlandırmak için tüm vücudu görmesi gerekir. Dar giysiler, hacimli veya katmanlı kıyafetlerden daha iyi vücut yapısını gösterir. Basit, dağınık olmayan arka planlar, yapay zekanın vücut şekline net bir şekilde odaklanmasını sağlar.

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

posesRequiredarray of objects

Oluşturmak istediğiniz pozları tanımlayan bir dizi. Aynı istekte şablon ve özel pozları karıştırıp eşleştirebilirsiniz.

Şablon Poz: Yapısal bir referans olarak bir görsel kullanır. Referans poz olarak kullanmak üzere herhangi bir geçerli görsel URL'si sağlayabilir veya aşağıda listelenen resmi olarak desteklenen şablonlarımızdan birini kullanabilirsiniz.
- type (dize): "template" olmalıdır.
- cdnUrl (dize): İstenen pozu gösteren referans görselin URL'si.
- title (dize, isteğe bağlı): Açıklayıcı bir etiket.
Özel Poz: Poza tanımlamak için bir metin istemi kullanır.
- type (dize): "custom" olmalıdır.
- text (dize): Yeni pozu açıklayan metin (örn. "kolları bağlı ayakta durma").

Resmi Poz Şablonları

Kendi referans görsellerinizi cdnUrl aracılığıyla sağlayabilseniz de, yüksek düzeyde optimize edilmiş poz şablonlarından oluşan seçilmiş bir dizin sunuyoruz. Pozu önizlemek için aşağıdaki herhangi bir URL'ye tıklayın.

Female Poses

Title	Template URL (`cdnUrl`)

Male Poses

Title	Template URL (`cdnUrl`)

İsteğe Bağlı Parametreler

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

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

ratiostring

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

Çalışma Zamanı Hataları

Bu özellik için çalışma zamanı hataları, Hata Yönetimi bölümünde belgelenen paylaşılan küme kullanılı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, istenen poz sayısına göre doğrusal olarak ölçeklenir ve seçilen çıktı quality katmanına bağlıdır.

Formül: Maliyet = KaliteKredileri × PozSayısı

Kalite Katmanı	Poz Başına Kredi
1k (Varsayılan)	1
2k	3
4k	5

Örnek: 1k kalitede 3 pozdan oluşan bir dizi istemek toplam 3 kredi maliyetindedir. Aynı 3 pozu 4k kalitede istemek toplam 15 kredi maliyetindedir.