Ana içeriğe geç

Meshy API 429 ve Hız Sınırı Hataları Nasıl Giderilir?

Meshy API Hız Sınırları: 429 Hatalarını Giderin

İçindekiler

Meshy API'sini çağırırken entegrasyonunuz 429, RateLimitExceeded veya NoMoreConcurrentTasks hatalarıyla karşılaşıyorsa, bu kılavuz bu sınırların neden var olduğunu ve entegrasyonunuzu bu sınırlar içinde çalışacak şekilde nasıl tasarlayacağınızı açıklar.

Hız sınırları neden vardır

Meshy'nin API'si, 3B modeller, dokular ve ilgili varlıkları oluşturmak için kullanılan paylaşılan GPU hesaplama kaynaklarının önünde yer alır. Hız sınırları ve eşzamanlılık üst sınırları, bu paylaşılan altyapıyı koruyarak üretim kalitesinin ve tamamlanma süresinin platformdaki her kullanıcı için tutarlı kalmasını sağlar. Her hesabın, mevcut planına bağlı olarak, belirli bir zaman aralığında yapabileceği maksimum istek sayısı ve aynı anda çalıştırabileceği (kuyrukta bekleyen veya devam eden) maksimum üretim görevi sayısı vardır.

İstek sınırı ile kuyruk/eşzamanlılık sınırı

İki farklı sınır vardır ve farklı şekilde hata verirler:

  • İstek hız sınırı (429 / RateLimitExceeded): dakika başına yapabileceğiniz API çağrısı sayısını (örn. görev oluşturma, durum yoklaması) sınırlar. Bu sınırı aşmak, kaç görevin çalıştığından bağımsız olarak API'yi çok sık çağırdığınız anlamına gelir.

  • Eşzamanlılık / kuyruk sınırı (NoMoreConcurrentTasks): aynı anda kuyruğa alınmış veya işlenmekte olan üretim görevlerinin sayısını sınırlar. Bu sınırı aşmak, zaten maksimum sayıda etkin göreve sahip olduğunuz ve başka bir görev göndermeden önce birinin bitmesini beklemeniz gerektiği anlamına gelir.

Planınızın mevcut istek ve eşzamanlılık sınırlarını Meshy kontrol panelinizden kontrol edin, çünkü bunlar plan katmanına göre değişebilir.

429 hataları için geri çekilme stratejisi

429 veya RateLimitExceeded yanıtı aldığınızda aynı isteği hemen yeniden denemeyin. Bunun yerine:

  • Üstel geri çekilme kullanın: kısa bir aralık bekleyin, ardından sonraki her başarısızlıkta bu süreyi ikiye katlayın; makul bir üst sınıra kadar.

  • Geri çekilme aralığınıza jitter (küçük bir rastgele sapma) ekleyin; böylece sisteminizdeki birden fazla çalışan aynı anda yeniden denemez.

  • Bekleme süresini tahmin etmek yerine, yanıtta varsa döndürülen Retry-After veya hız sınırı başlıklarına uyun.

  • Kalıcı bir başarısızlığın sonsuza kadar döngüye girmemesi için istek başına yeniden deneme sayısını sınırlayın.

Eşzamanlılık sınırlarına göre planlama

NoMoreConcurrentTasks hatası, hesabınızın etkin görev tavanına zaten ulaştığınız anlamına gelir. Üretimde bu hataya çarpmamak için:

  • Yalnızca önceki bir görev tamamlandığında veya etkin görev sayınız sınırın altına düştüğünde yeni bir üretim görevi gönderen, kendi uygulamanızda yerel bir kuyruk veya iş zamanlayıcı bulundurun.

  • Bir yuva boşaldığında haberdar olmak için tahminî gönderim yapmak yerine görev durumunu yoklayın (veya iş akışınızda destekleniyorsa webhook'ları kullanın).

  • Toplu üretim işlerini tek seferde tüm istekleri göndermek yerine gruplandırın ve sınırlayın; bu, hem istek hızınızı hem de eşzamanlı görev sayınızı dengeler.

  • 429/NoMoreConcurrentTasks hatalarındaki bir artışın kullanıcılarınızı etkilemeden önce görünür olması için kendi tarafınızda izleme/uyarı mekanizması kurun.

Başarısız veya yetersiz üretimleri yeniden deneme

Meshy API şu anda bireysel veya stüdyo planlarında mevcut bir üretim için yerleşik bir "yeniden deneme" özelliğini desteklemiyor — bir sonuç beklentilerinizi karşılamıyorsa, normal şekilde kredi harcayan yeni bir üretim isteği gönderirsiniz. Otomatik hattınız geçici hataları (429 gibi) ele aldığında, yeniden deneme mantığınızın her seferinde yinelenen üretim görevleri oluşturmadığından, yalnızca geri çekilme uygulandıktan sonra orijinal isteği yeniden gönderdiğinden emin olun.

Planınızı yükseltmeyi ne zaman düşünmelisiniz

Geri çekilme ve eşzamanlılık farkındalıklı kuyruk uyguladıysanız ve hâlâ sürekli olarak hız veya eşzamanlılık sınırlarına çarpıyorsanız, bu genellikle entegrasyonunuzun işlem hacmi ihtiyaçlarının mevcut planınızın sınırlarını aştığının bir işaretidir. Mevcut planınızın istek ve eşzamanlılık izinlerini kontrol panelinizden kontrol edin; sürekli olarak daha yüksek işlem hacmine ihtiyaç duyuyorsanız planınızı yükseltmeyi veya kurumsal düzeyde API erişimi için Meshy satış ekibiyle iletişime geçmeyi düşünün.

SSS

1. 429 veya RateLimitExceeded hatası ne anlama gelir?

Planınız için belirli bir zaman aralığında izin verilen API isteği sayısını aştığınız anlamına gelir. Yeniden denemeden önce istek hızınızı düşürün ve üstel geri çekilme uygulayın.

2. NoMoreConcurrentTasks ne anlama gelir?

Hesabınız için kuyrukta bekleyen veya devam eden üretim görevlerinin zaten maksimum sayıya ulaştığı anlamına gelir. Daha fazla görev göndermeden önce mevcut bir görevin tamamlanmasını bekleyin veya aynı anda gönderdiğiniz görev sayısını azaltın.

3. Hesabımın hız ve eşzamanlılık sınırlarını nasıl öğrenirim?

Mevcut planınızla ilişkili sınırlar için Meshy kontrol panelinizi kontrol edin; bu sınırlar plan kademeleri arasında farklılık gösterebilir.

4. Meshy üretim görevleri için otomatik yeniden denemeyi destekliyor mu?

Hayır, bireysel veya studio planlarında desteklemez — başarısız veya yetersiz bir üretim, normal şekilde kredi kullanılarak yeni bir istek olarak yeniden gönderilmelidir. Kurumsal müşteriler yeniden deneme işlevi için satış ekibiyle iletişime geçmelidir.

5. Bir üretim hattında bu hatalara çarpmaktan kaçınmanın en iyi yolu nedir?

Gönderimleri eşzamanlılık sınırınızın altında tutacak şekilde sınırlayan yerel bir kuyruk uygulayın, her 429 yanıtı için rastgelelik eklenmiş üstel geri çekilme kullanın ve kullanıcılarınızı etkilemeden önce tepki verebilmek için hata oranlarını izleyin.

6. Hız sınırları nedeniyle planımı ne zaman yükseltmeliyim?

Geri çekilme ve eşzamanlılık farkındalıklı kuyruklamayı zaten uyguladıysanız ve yine de bu sınırlara düzenli olarak çarpıyorsanız, kullanımınız büyük ihtimalle mevcut planınızı aşmıştır — kontrol panelinizi kontrol edin veya daha yüksek işlem hacimli bir plan için satış ekibiyle iletişime geçin.


İlgili Makaleler

Bu, sorunuzu yanıtladı mı?