Tamamen benzersiz yapay zeka moda modelleri oluşturun veya denemelerde kullanmak üzere özel referans görselleri yükleyin.

Model Oluşturma

Model Oluşturma, basit, sezgisel istemler veya referans görsellerle gerçekçi moda modelleri oluşturmanıza veya mevcut model görsellerini çalışma alanınıza yüklemenize olanak tanır.

Model Adı: model-create

Yaşam Döngüsü: stable

İşlem Süresi: ~10s–30s (yüz/poz gibi gelişmiş referanslar kullanıldığında artar)

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

Teslimat Yöntemleri: URL

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

İstek

Yapılandırmanızı evrensel /v1/run uç noktasına göndererek moda modelleri oluşturun veya yükleyin:

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": "model-create",
           "inputs": {
             "type": "generate",
             "name": "Summer Collection Model",
             "prompt": "Full body shot, woman wearing a white t-shirt and dark blue biker shorts, studio lighting",
             "gender": "female",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

Yanıt

Model oluşturma 30 saniyeye kadar sürebileceğinden, /v1/run uç noktası hemen eşzamansız bir iş id 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 yeniden 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 modelinize 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/model-123.png"
  ]
}

İstek Parametreleri

Gerekli Parametreler

typeRequired'generate' | 'upload'

Yapay zeka aracılığıyla yeni bir model oluşturulacağını (generate) veya mevcut bir görselin yükleneceğini (upload) belirtir.

nameRequiredstring

Modeliniz için açıklayıcı bir ad. Bu, modeli stüdyonuzda tanımlamak için kullanılır.

promptstring

Oluşturma için gerekli Oluşturulacak modelin metin açıklaması. İstenen moda modelini, kıyafetleri, pozu ve arka plan sahnesini tanımlar.

Profesyonel İpucu: Eğer faceModelId gibi bir referans kullanıyorsanız, yapay zeka referansın kimliğine öncelik verecek ancak ayarı, kıyafeti ve vücut özelliklerini belirlemek için isteminizi kullanacaktır. Yalnızca bir faceModelId sağlanmışsa isteğe bağlıdır.

imageBase64string

Yükleme için gerekli Base64 kodlu görsel dizesi. type upload olarak ayarlandığında gereklidir.

Biçimlendirme Gereksinimi Base64 dizeniz, standart veri URI önekini içermelidir (örn. data:image/jpeg;base64,... veya data:image/png;base64,...). Yalnızca ham kodlanmış dize sağlanırsa yükleme başarısız olacaktır.

İsteğe Bağlı Oluşturma Parametreleri

Bu parametreler, type generate olarak ayarlandığında geçerlidir.

genderstring

Modelin cinsiyeti. Oluşturma modeline fiziksel özellikleri belirlemede yardımcı olur.

bodyTypestring

Modelin vücut tipi (örn. "atletik", "büyük beden", "ince").

clothingstring

Oluşturma sırasında uygulanacak belirli giyim detayları, ana prompt'u zenginleştirir.

posestring

Pozun metinsel açıklaması (örn. "elleri cebinde ayakta duran", "yürüyen").

faceModelIdstring

Nesiller boyunca belirli bir kimliği sabitlemek için mevcut bir yüz modelinin UUID'si. Çıktı, referans yüzü korurken hedef isteme uyum sağlayacaktır.

Not: Bir yüz referansı sağlamak, yapay zeka kimliği hizalarken toplam işlem süresine birkaç saniye ekler.

poseModelIdstring

Mevcut bir poz modelinin UUID'si. Oluşturmayı, vücut pozu ve duruşu için referansla kesinlikle eşleşmeye zorlar.

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

poseImageBase64string

Kaydedilmiş bir poseModelId sağlamak yerine geçici bir poz referansı olarak kullanılacak Base64 kodlu görsel dizesi.

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

Çıktı çözünürlük katmanı. 1k ~1 megapiksel çıktı, 2k ~4 megapiksel ve 4k ~16 megapiksel üretir. Daha yüksek çözünürlükler daha fazla kredi tüketir. Varsayılan: 1k

aspectRatiostring

Oluşturulan görselin genişlik-yükseklik oranını tanımlar.

Desteklenen değerler: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

Varsayılan: 3:4

sampleCountinteger

İstek başına oluşturulacak görsel varyasyonlarının sayısı. 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 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

Geliştirici API istekleri için maliyet, seçilen çıktı quality katmanına bağlıdır.

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