API Temelleri

Fit-it-on Geliştirici API'si, yapay zeka üretim modellerimize programatik erişim sağlar. Standart REST mimari stillerini takip eder, öngörülebilir kaynak odaklı URL'ler kullanır ve JSON kodlu istek gövdelerini kabul eder.

Eşzamansız Yürütme

Tüm görüntü üretimleri eşzamansız olarak işlenir. Yüksek çözünürlüklü yapay zeka render'ları (2k veya 2048x2048 örnekleri) zaman alır ve eşzamanlı bir bağlantı kaçınılmaz olarak zaman aşımına uğrardı.

1. Bir İş Gönderin: Giriş verilerinizle bir POST /v1/run isteği gönderirsiniz.
2. Kimlik Alın: API hemen bir prediction_id ile 200 OK döndürür.
3. Durum İçin Yoklama Yapın: Periyodik olarak GET /v1/status/{predictionId} çağrısı yaparsınız.
4. Tamamlama: Durum succeeded konumuna geçtiğinde, oluşturulan görsellerinizin URL'leri output dizisinde mevcut olacaktır.

Temel URL

Tüm istekler, üretim ortamımıza HTTPS üzerinden yapılmalıdır:

https://fititon.app/api

İçerik Türleri

Tüm POST ve PATCH istekleri, yük formatını belirtmek için aşağıdaki başlığı içermelidir:

Content-Type: application/json

API ayrıca tüm yanıtları kesinlikle JSON formatında döndürür.

Webhook'lar

JSON yükünüzün kökünde bir webhook_url sağlarsanız, eşzamansız iş tamamlanır tamamlanmaz (başarılı veya hatayla) o URL'ye bir HTTP POST isteği göndereceğiz.

Webhook Yük Örneği:

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "success",
  "output": [
    "https://storage.fititon.com/results/result-123.jpg",
    "https://storage.fititon.com/results/result-124.jpg"
  ],
  "error": null,
  "created_at": "2026-07-03T10:00:00.000Z",
  "updated_at": "2026-07-03T10:00:15.000Z"
}

İstek Limitleri ve İşleme

Kötüye kullanımı önlemek için API, aktif Geliştirici Planı katmanınıza göre bir hız limiti uygular.

Limitinizi aşarsanız, bir 429 Too Many Requests hatası alırsınız. Uygulamanız, üstel geri çekilme (exponential backoff) uygulayarak bunu zarif bir şekilde ele almalıdır.