API Əsasları

Fit-it-on Tərtibatçı API-si süni intellekt nəsil modellərimizə proqramlı giriş imkanı verir. O, standart REST arxitektura üslublarına əməl edir, proqnozlaşdırıla bilən resurs yönümlü URL-lərdən istifadə edir və JSON ilə kodlanmış sorğu gövdələrini qəbul edir.

Asinxron İcra

Bütün şəkil generasiyaları asinxron şəkildə işlənir. Yüksək keyfiyyətli süni intellekt renderləri (2k və ya 2048x2048 nümunələr) vaxt tələb edir və sinxron əlaqə qaçılmaz olaraq vaxt aşımına uğrayacaq.

1. Tapşırıq Göndərin: Giriş məlumatlarınızla birlikdə bir POST /v1/run sorğusu göndərirsiniz.
2. ID Qəbul Edin: API dərhal bir prediction_id ilə 200 OK cavabı qaytarır.
3. Statusu Yoxlayın: Siz dövri olaraq GET /v1/status/{predictionId} çağırışını edirsiniz.
4. Tamamlanma: Status succeeded vəziyyətinə keçdikdə, yaradılmış şəkillərinizin URL-ləri output massivində mövcud olacaq.

Əsas URL

Bütün sorğular HTTPS üzərindən istehsal mühitimizə edilməlidir:

https://fititon.app/api

Məzmun Növləri

Bütün POST və PATCH sorğuları yük formatını müəyyən etmək üçün aşağıdakı başlığı ehtiva etməlidir:

Content-Type: application/json

API həmçinin bütün cavabları ciddi şəkildə JSON formatında qaytarır.

Webhooklar

JSON yükünüzün kökündə bir webhook_url təqdim etsəniz, asinxron tapşırıq tamamlandıqdan dərhal sonra (uğurlu və ya səhvlə) həmin URL-ə bir HTTP POST sorğusu göndərəcəyik.

Webhook Yük Nümunəsi:

{
  "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"
}

Sorğu Limitləri və İdarəetmə

Sui-istifadənin qarşısını almaq üçün API, aktiv Tərtibatçı Planınızın səviyyəsinə əsaslanan sürət limiti tətbiq edir.

Limitinizi aşsanız, 429 Too Many Requests xətası alacaqsınız. Tətbiqiniz eksponensial geri çəkilməni tətbiq etməklə bunu zərif şəkildə idarə etməlidir.