Herhangi bir moda görüntüsünün yeni görüş açılarını oluşturmak için sanal kamerayı döndürün.

Açı Oluşturma

Açı Oluşturma uç noktası, mevcut bir görüntüyü alıp sanal kamerayı yeniden konumlandırarak model, giysi, dokular ve aydınlatmayı korurken yeni görüş açıları (örn. ön, arka, yan profiller) oluşturmanıza olanak tanır.

Model Adı: angle-generation

Yaşam Döngüsü: kararlı

İşlem Süresi: ~10sn–20sn

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

Teslimat Yöntemleri: URL, Base64 (önizleme)

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

İstek

Görüntünüzü ve istenen açıları 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": "angle-generation",
           "inputs": {
             "imageUrl": "https://example.com/front-view.jpg",
             "angleIds": ["back", "leftSide"],
             "quality": "2k"
           }
         }'

Yanıt

Açı oluşturma 20 saniyeye kadar sürebileceğinden, /v1/run uç noktası hemen bir 201 Created durumu ve eşzamansız bir iş id'si 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
}

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

İstek Parametreleri

Gerekli Parametreler

imageUrlRequiredstring

Döndürülecek kaynak görüntü. Herkese açık bir URL veya Base64 kodlu bir görüntü dizesi olabilir.

Profesyonel İpucu: Öne bakan fotoğraflar en tutarlı çok açılı sonuçları verir. Açılı veya yana bakan kaynak görüntülerden kaçının — ön görünümler yapay zekaya üzerinde çalışacak en fazla şeyi verirken, açılı çekimler yapay zekayı eksik yapısal detayları hayal etmeye zorlar.

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

angleIdsRequiredarray of strings

Oluşturmak istediğiniz açı tanımlayıcılarından oluşan bir dizi. Mevcut seçenekler şunlardır:

"front": Ön Görünüm
"back": Arka Görünüm
"leftSide": Sol Taraf (90°)
"rightSide": Sağ Taraf (90°)
"left45": Sol 45°
"right45": Sağ 45°

İsteğe Bağlı Parametreler

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

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

ratiostring

En boy oranı geçersiz kılma (örn. 16:9, 3:4). 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 özelliğe ilişkin çalışma zamanı hataları, Hata Yönetimi bölümünde belgelenen ortak kümesi 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, istenen açı 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 × AçıSayısı

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

Örnek: 1k kalitede ["back", "leftSide", "rightSide"] istemek toplam 3 kredi maliyetindedir. Aynı 3 açıyı 4k kalitede istemek toplam 15 kredi maliyetindedir.