Hız Limitleri

Hız limitleri, API'mizin bir kullanıcının veya istemcinin hizmetlerimize belirli bir zaman dilimi içinde kaç kez erişebileceğine dair getirdiği kısıtlamalardır.


Neden Limitler

Herkes için en iyi deneyimi yaratmaya yardımcı olmak amacıyla API'mize hız limitleri koyduk. İşte önemli olma nedenleri:

  • Hizmetimizi güvende ve sağlam tutmak için! Hız limitlerini dost canlısı fedailer olarak düşünün - kimsenin API'mizi tek seferde çok fazla istekle boğmasını engellerler. Bu, hizmetimizi olası kötüye kullanımlardan korumaya yardımcı olur ve her şeyin sorunsuz çalışmasını sağlar.

  • Herkesin adil payını almasını sağlamak için. Tıpkı bir oyun bahçesinde oyuncakları paylaşmak gibi, tüm kullanıcılarımızın API'ye eşit erişime sahip olmasını istiyoruz. Her kullanıcının yapabileceği istek sayısını nazikçe sınırlandırarak, hiç kimsenin sırası için çok uzun beklemek zorunda kalmamasını sağlıyoruz.

  • Performansı hızlı ve güvenilir tutmak için. İsteklerin genel akışını yöneterek, tüm harika kullanıcılarımız için hızlı yanıt sürelerini ve istikrarlı hizmeti koruyabiliyoruz. Bu, bir otoyolun aşırı kalabalıklaşmamasını sağlamak gibidir - tıkanıklığı önlediğimizde trafik daha iyi akar!


Limitler Nasıl Çalışır

Hız limitleri 2 şekilde ölçülür:

  • saniyedeki istek: Saniyede yapabileceğiniz ağ isteği sayısıdır.
  • kuyruk görevleri: Herhangi bir anda kuyrukta çalıştırabileceğiniz eşzamanlı üretim görevi sayısıdır.

Kuyruk görevleri, Metinden 3D'ye, Görselden 3D'ye, Metinden dokuya ve Yeniden ağ endpoint'lerini içerir. Upload ve Balance gibi diğer endpoint'ler bu limite dahil değildir.

Limitler hesap bazında uygulanır. Bu, limitlerin tüm API key'leriniz arasında paylaşıldığı anlamına gelir.

Hız limitlerinin yanı sıra, görev işleme önceliği de görevlerinizin hızını etkileyecektir.

Her kullanıcı katmanının, ihtiyaçlarına uygun belirli hız limitleri ve öncelik seviyeleri vardır. İşte katmanlara göre güncel limitler:

Kullanıcı Katmanısaniyedeki istekkuyruk görevleriÖncelik Seviyesi
Pro2010Varsayılan
Premium2030Pro'dan Yüksek
Ultra20100En Yüksek
Studio2020Pro'dan Yüksek
Enterprise100Varsayılan 100, özelleştirilebilirEn Yüksek

Bu limitleri aşarsanız, API'mizden 429 Too Many Requests yanıtı alırsınız. Bu duruma yol açabilecek iki tür sınır aşımı vardır ve her biri farklı bir yanıt döndürür:

  • İstek Aşımı: Bu, saniyede çok fazla istek yaptığınızda gerçekleşir. RateLimitExceeded mesajıyla birlikte 429 Too Many Requests yanıtı alırsınız.
  • Kuyruk Aşımı: Bu, çok fazla eşzamanlı üretim göreviniz çalıştığında gerçekleşir. NoMoreConcurrentTasks mesajıyla birlikte 429 Too Many Requests yanıtı alırsınız.