Hız Limitleri

Hız limitleri, API'mizin belirli bir zaman diliminde bir kullanıcı veya istemcinin hizmetlerimize erişebileceği sayıyı sınırlayan kısıtlamalardır.

Neden Limitler

API'mizde hız limitlerini herkes için en iyi deneyimi yaratmak amacıyla koyduk. İşte neden önemli oldukları:

Hizmetimizi güvenli ve sağlam tutmak için! Hız limitlerini dost canlısı güvenlik görevlileri olarak düşünün - API'mizi bir anda çok fazla istekle bunaltamayacaklarından emin olurlar. Bu, hizmetimizi potansiyel kötüye kullanımdan korur ve her şeyin sorunsuz çalışmasını sağlar.
Herkesin adil payını almasını sağlamak için. Tıpkı bir oyun alanında 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ırlayarak, kimsenin sırasını 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üreleri ve istikrarlı hizmet sağlayabiliriz. Bu, bir otoyolun çok kalabalık olmamasını sağlamak gibidir - trafik sıkışıklığını önlediğimizde daha iyi akar!

Limitler Nasıl Çalışır

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

Saniyedeki İstek: Bu, saniyede yapabileceğiniz ağ isteklerinin sayısıdır.
Kuyruk Görevleri: Bu, herhangi bir zamanda kuyrukta çalıştırabileceğiniz eşzamanlı üretim görevlerinin 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 limite dahil değildir.

Limitler hesap bazında uygulanır. Bu, limitlerin tüm API anahtarlarınız 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ı, ihtiyaçlarına uygun belirli hız limitleri ve öncelik seviyelerine sahiptir. İşte katmana göre mevcut limitler:

Kullanıcı Katmanı	Saniyedeki İstek	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 limitleri aşarsanız, API'mizden 429 Too Many Requests yanıtı alırsınız. Bu durumu tetikleyebilecek iki tür isabet vardır, her biri farklı bir yanıtla:

İstek İsabeti: Bu, saniyede çok fazla istek yaptığınızda meydana gelir. RateLimitExceeded mesajıyla birlikte 429 Too Many Requests yanıtı alırsınız.
Kuyruk İsabeti: Bu, çok fazla eşzamanlı üretim göreviniz olduğunda meydana gelir. NoMoreConcurrentTasks mesajıyla birlikte 429 Too Many Requests yanıtı alırsınız.