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 istek | kuyruk görevleri | Öncelik Seviyesi |
|---|---|---|---|
| Pro | 20 | 10 | Varsayılan |
| Premium | 20 | 30 | Pro'dan Yüksek |
| Ultra | 20 | 100 | En Yüksek |
| Studio | 20 | 20 | Pro'dan Yüksek |
| Enterprise | 100 | Varsayılan 100, özelleştirilebilir | En 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.
RateLimitExceededmesajıyla birlikte429 Too Many Requestsyanıtı alırsınız. - Kuyruk Aşımı: Bu, çok fazla eşzamanlı üretim göreviniz çalıştığında gerçekleşir.
NoMoreConcurrentTasksmesajıyla birlikte429 Too Many Requestsyanıtı alırsınız.