Hız Sınırları

Hız sınırları, API'mizin bir kullanıcının veya istemcinin hizmetlerimize belirli bir süre içinde kaç kez erişebileceği konusunda getirdiği 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 bunların önemli olma nedenleri:

• Hizmetimizi güvenli ve sağlam tutmak için! Hız sınırlarını dost canlısı fedailer gibi düşünün - kimsenin API'mizi aynı anda çok fazla istekle bunaltamamasını sağlarlar. Bu, hizmetimizi olası kötüye kullanımlardan korur 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 oyuncak 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, 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 kararlı hizmeti koruyabiliyoruz. Bu, bir otoyolun fazla kalabalıklaşmamasını sağlamak gibidir - tıkanı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: 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, hesabınızda PENDING veya IN_PROGRESS durumunda olan görevlerdir. Bir görev oluşturan her uç nokta (örneğin Metinden 3D'ye, Görselden 3D'ye, Çoklu görselden 3D'ye, Yeniden dokulama, Yeniden ağ, Rigging, Animasyon, Metinden görsele, 3D baskı uç noktaları ve Creative Lab) yeni bir görevi kabul etmeden önce bu sınırı kontrol eder. Balance, Usage gibi görev oluşturmayan istekler ile görevleri getirme, listeleme veya akışla izleme işlemleri bu sınıra dahil edilmez, ancak yine de saniyedeki istek sayısına dahil edilir.

Sınırlar hesap bazında uygulanır, bu nedenle tüm API anahtarlarınız ve Playground arasında paylaşılır. Meshy web uygulamasında başlattığınız görevler de kuyruk görevlerinize dahildir.

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ının ihtiyaçlarına uygun şekilde tasarlanmış belirli hız sınırları ve öncelik seviyeleri vardır. İşte katmanlara göre güncel sınırlar:

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 durum vardır, her birinin farklı bir yanıtı vardır:

• İstek Aşımı: Bu, saniyede çok fazla istek yaptığınızda gerçekleşir. Rate limit exceeded mesajıyla birlikte bir 429 Too Many Requests yanıtı alırsınız.
• Kuyruk Aşımı: Bu, çok fazla eşzamanlı üretim göreviniz çalışıyorken gerçekleşir. NoMorePendingTasks (ya da krediniz tükendiğinde NoMoreConcurrentTasks) mesajıyla birlikte bir 429 Too Many Requests yanıtı alırsınız. Bu 429 yanıtında Retry-After bulunmaz: başka bir görev oluşturmadan önce görevlerinizden birinin tamamlanmasını bekleyin.

---

Hız Sınırı Başlıkları

API yanıtları, isteklerinizi hızınızı ayarlayabilmeniz için şu başlıkları taşır:

Retry-After mevcut olduğunda, bir sonraki isteği göndermeden önce belirtilen saniye kadar bekleyin.