Hız sınırları

Planınızın izin verdiği istek ve görev sayısını, bir limite ulaştığınızda ne yapmanız gerektiğini öğrenin.

Plana göre limitler

API'yi herkes için hızlı ve kullanılabilir tutmak için Meshy her hesabı iki şekilde sınırlandırır:

Saniyedeki istek: her saniye kaç API isteği gönderebileceğiniz.
Eşzamanlı görevler: görevlerinizden kaç tanesinin aynı anda PENDING veya IN_PROGRESS durumunda olabileceği.

Limitler planınıza bağlıdır:

Plan	Saniyedeki istek	Eşzamanlı görev	Öncelik
Pro	20	10	Varsayılan
Premium	20	30	Pro'dan daha yüksek
Ultra	20	100	En yüksek
Studio	20	60, veya bazı önceki Studio planlarında 20	Pro'dan daha yüksek
Enterprise	100	Varsayılan olarak 100, veya özel bir limit	En yüksek

Öncelik bir limit değildir. Kuyruk yoğun olduğunda Meshy, önceliği daha yüksek olan görevleri önce başlatır.

Her limite neyin dahil olduğu

Görevleri alan, listeleyen veya akış olarak ileten istekler de dahil olmak üzere her API isteği, saniyedeki istek limitine dahildir. Meshy web uygulamasından gelen istekler sayılmaz.

Eşzamanlı görev limiti istekleri değil, görevleri sayar. Bir görev oluşturan her uç nokta, görevi oluşturmadan önce bu limiti kontrol eder. Ö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 bu kontrolü yapar.

Görev oluşturmayan istekler bu limite dahil değildir. Örneğin, Bakiye, Kullanım ve görevleri alan, listeleyen veya akış olarak ileten istekler sayılmaz.

Kimin limitlerinin uygulandığı

Aşağıdaki tablo, API anahtarlarınızın, Playground'un ve web uygulamasının kimin limitlerine dahil olduğunu gösterir:

Nerede çalıştığınız	Kişisel hesap	Takım
API anahtarları	Sizin limitleriniz	Takımdaki her API anahtarı tarafından paylaşılan takım limitleri
Playground	Sizin limitleriniz	Oturum açmış üye olarak kendi limitleriniz
Web uygulaması	Sizin eşzamanlı görevleriniz	Kendi eşzamanlı görevleriniz. Takım sahibinin başlattığı görevler de takımın limitlerine dahil olur.

Bir limite ulaştığınızda

Bir limiti aştığınızda, API 429 Too Many Requests döndürür. Mesaj, hangi limite ulaştığınızı belirtir:

Saniyede çok fazla istek: mesaj Rate limit exceeded şeklindedir. Retry-After başlığındaki saniye sayısı kadar bekleyin, ardından yeniden deneyin.
Çok fazla eşzamanlı görev: mesaj NoMorePendingTasks ile başlar. Kredisi kalmamış sınırsız bir planda ise NoMoreConcurrentTasks ile başlar. Bu 429 yanıtında Retry-After başlığı bulunmaz. Görevlerinizden birinin tamamlanmasını bekleyin, ardından bir sonrakini oluşturun.

Hız sınırı başlıkları

API yanıtları, isteklerinizin hızını ayarlamanıza yardımcı olmak için şu başlıkları içerir:

Başlık	Açıklama
`X-RateLimit-Limit`	Planınızda saniyede izin verilen istek sayısı.
`X-RateLimit-Remaining`	Mevcut saniyede kalan istek sayısı.
`X-RateLimit-Reset`	Bütçenizin yeniden dolmasına kalan saniye.
`Retry-After`	Bir sonraki isteğinizden önce beklemeniz gereken saniye. Saniyedeki istek sayısının aşılması durumunda bir `429` ile birlikte ve hâlâ `PENDING` veya `IN_PROGRESS` durumunda olan bir görev aldığınızda gönderilir.

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