Oluşturulan moda görsellerinizin çözünürlüğünü ve ayrıntılarını yükseltin ve geliştirin.

Kalite Geliştirici (Yükseltme)

Kalite Geliştirici uç noktası, görüntülerin çözünürlüğünü ve daha ince ayrıntılarını akıllıca yükseltmenize ve geliştirmenize olanak tanır, 4K çözünürlüğe kadar destekler.

Model Adı: upscale

Yaşam Döngüsü: stable

İşlem Süresi: ~8s–20s

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

Teslimat Yöntemleri: URL

Krediler: 3 to 4 per image (2k: 3, 4k: 4)

İstek

Görselinizi ve hedef çözünürlüğünüzü 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": "upscale",
           "inputs": {
             "imageUrl": "https://example.com/1k-image.jpg",
             "targetQuality": "2k"
           }
         }'

Yanıt

Yükseltme işlemi 20 saniyeye kadar sürebileceğinden, /v1/run uç noktası hemen eşzamansız bir iş id ile 201 Created durumu döndürür. Nihai görüntüyü almak için bu id'yi 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": "2024-03-10T12:00:00Z",
  "model_name": "upscale"
}

İş tamamlandığında (status: "success"), output alanı sonuç URL'lerinin dizisini içerecektir:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/upscale-123.jpg"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

İstek Parametreleri

Gerekli Parametreler

imageUrlRequiredstring

Yükseltmek istediğiniz kaynak görsel. Herkese açık bir URL veya Base64 kodlu bir görsel dizesi olabilir.

Biçimlendirme ve Yük Gereksinimi Bir Base64 dizesi gönderirken, standart veri URI önekini (örn. data:image/jpeg;base64,...) içermelidir. Ayrıca, genel JSON yük boyutu sınırlarına (HTTP 413) takılmamak için 3MB'den büyük görseller için standart HTTP URL'leri kullanmanızı şiddetle tavsiye ederiz.

targetQualityRequired'2k' | '4k'

İstenen çıktı çözünürlük katmanı. Not: 4.25 megapikselden büyük görseller targetQuality="2k" kullanamaz ve 4k hedeflemelidir.

Ç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üncellenecek ve error alanı belirli hata nedenini içerecektir.

Kredi Maliyeti

Geliştirici API istekleri için maliyet, targetQuality'ye bağlı olarak değişir.

Formül: Maliyet = KaliteKredileri

Parametre	Görsel Başına Kredi
`targetQuality="2k"`	3
`targetQuality="4k"`	4