Hız sınırları

Hız sınırları, API'mizin bir kullanıcının veya istemcinin belirli bir süre içinde hizmetlerimize kaç kez erişebileceğine koyduğu kısıtlamalardır.

Neden sınırlar

Herkes için en iyi deneyimi oluşturmaya yardımcı olmak amacıyla API'mizde hız sınırları uyguluyoruz. İşte neden önemli oldukları:

Hizmetimizi güvenli ve sağlam tutmak için! Hız sınırlarını dost canlısı kapı görevlileri gibi düşünün; kimsenin API'mizi aynı anda çok fazla istekle bunaltmamasını sağlarlar. Bu, hizmetimizi olası kötüye kullanımdan korumaya yardımcı olur ve her şeyin sorunsuz çalışmasını sağlar.
Herkesin adil payını aldığından emin olmak için. Bir oyun parkında oyuncakları paylaşmak gibi, tüm kullanıcılarımızın API'ye eşit erişime sahip olduğundan emin olmak istiyoruz. Her kullanıcının yapabileceği istek sayısını nazikçe sınırlandırarak, kimsenin sırasını çok uzun süre beklemek zorunda kalmamasını sağlarız.
Performansı hızlı ve güvenilir tutmak için. Genel istek akışını yöneterek, tüm harika kullanıcılarımız için hızlı yanıt süreleri ve kararlı hizmet sağlayabiliriz. Bu, bir otoyolun çok kalabalık olmamasını sağlamak gibidir; sıkışıklığı önlediğimizde trafik daha iyi akar!

Sınırlar nasıl çalışır

Hız sınırları 2 şekilde ölçülür:

saniyedeki istek: Bu, saniye başına yapabileceğiniz ağ isteği sayısıdır.
kuyruk görevleri: Bu, herhangi bir anda kuyrukta aynı anda çalıştırabileceğiniz eşzamanlı oluşturma görevi sayısıdır.

Kuyruk görevleri Metinden 3D'ye, Görselden 3D'ye, Metinden dokuya ve Yeniden ağ endpointlerini içerir. Yükleme ve bakiye gibi diğer endpointler bu sınıra dahil değildir.

Sınırlar hesap bazında uygulanır. Bu, sınırların tüm API keyleriniz arasında paylaşıldığı anlamına gelir.

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

Her kullanıcı katmanı, ihtiyaçlarına uyacak şekilde tasarlanmış belirli hız sınırlarına ve öncelik seviyelerine sahiptir. Katmana göre mevcut sınırlar şunlardır:

Kullanıcı katmanı	saniyedeki istek	kuyruk görevleri	Öncelik seviyesi
Pro	20	10	Varsayılan
Premium	20	30	Pro'dan daha yüksek
Ultra	20	100	En yüksek
Studio	20	20	Pro'dan daha yüksek
Enterprise	100	Varsayılan 50, özelleştirilebilir	En yüksek

Bu sınırları aşarsanız, API'mizden bir 429 Too Many Requests yanıtı alırsınız. Bunu tetikleyebilecek iki tür isabet vardır ve her birinin farklı bir yanıtı bulunur:

İstek isabeti: Bu, saniyede çok fazla istek yaptığınızda gerçekleşir. RateLimitExceeded mesajıyla birlikte bir 429 Too Many Requests yanıtı alırsınız.
Kuyruk isabeti: Bu, çalışan çok fazla eşzamanlı oluşturma göreviniz olduğunda gerçekleşir. NoMoreConcurrentTasks mesajıyla birlikte bir 429 Too Many Requests yanıtı alırsınız.