Referans · Rate limit'ler

Photta API rate limit'leri ve nazikçe nasıl polling yapılacağı

Tek cümlede

Photta API, sabit bir pencerede API anahtarı başına dakikada 600 isteğe izin verir. Bir 429 yanıtı Retry-After: 30 taşır. Bir işi her 3 saniyede bir poll edin; eşzamanlı çalışma planla sınırlandırılmıştır.

  • Sınırlar: 600 istek/dk
  • Retry-After: Retry-After: 30s
  • İşleme: asenkron, polling

Bu sayfadaki her veri şuradan alınmıştır: Photta API dokümantasyonu · kontrol edildi

Yayımlanan sınırlar

Dokümantasyonda belirtildiği şekliyle istek oranı, pencere, yeniden deneme, görsel boyutu ve formatları.

Sınırlar

  • API anahtarı başına dakikada 600 istek (Sabit pencere; limit her planda aynıdır)
  • 429 yanıtı Retry-After: 30 saniye içerir
  • Görsel başına en fazla 10 MB
  • Formatlar: JPEG, PNG, WebP
  • Plan başına eşzamanlı toplu işlem: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
  • Yalnızca polling — API webhook göndermez.

Plana göre eşzamanlı çalışma

Bir gönderim 409 dönmeden önce aynı anda en fazla kaç toplu işlemin işlemde (in flight) olabileceği.

Plan başına işlemdeki (in-flight) toplu işlemler

Free

Eşzamanlı: 1

Hobby

Eşzamanlı: 2

Seller

Eşzamanlı: 3

Brand

Eşzamanlı: 4

Studio

Eşzamanlı: 6

Sınırlar içinde kalmak

  • Sabit bir pencere

    Sınır, sabit bir pencerede API anahtarı başına sayılır ve her planda aynıdır. İki anahtar, iki bütçe anlamına gelir.

  • Her 3 saniyede bir poll edin

    Polling tek tamamlanma sinyalidir — API webhook göndermez. Her 3 saniye dokümante edilmiş aralıktır; daha hızlısı bütçenizi boş yanıtlar için harcar.

  • Üstel olarak geri çekilin

    Bir 429 yanıtından sonra, Retry-After saniyesi kadar bekleyin ve ardından sabit bir aralıkla yeniden denemek yerine sonraki her başarısızlıkta bekleme süresini artırın.

  • Toplu işlemler ayrı olarak sınırlandırılır

    Rate limit istekleri sayar; eşzamanlılık sınırı ise işlenmekte olan işleri sayar. Sınırı aşan bir toplu işlem 429 değil, 409 döndürür.

Rate limit'ler hakkında sorular

Rate limit nedir?

Sabit bir zaman penceresinde API anahtarı başına dakikada 600 istek. Dokümantasyon her endpoint için aynı sayıyı belirtir.

Bir işi ne sıklıkla poll etmeliyim?

Her 3 saniyede bir. Webhook bulunmadığından, bir işin tamamlandığını öğrenmenin dokümante edilmiş yolu polling yapmaktır.

Aynı anda ne kadar render alınabilir?

İşlenmekte olan toplu işlemler plana göre sınırlandırılır: Free 1, Hobby 2, Seller 3, Brand 4 ve Studio 6. Sınır aşıldığında gönderilen istek 409 döndürür.

429 aldığımda ne yapmalıyım?

Retry-After başlığını okuyun, belirtilen saniye kadar bekleyin, ardından üstel geri çekilme ile yeniden deneyin. İşi düşürmek yerine kuyruğa alın.

Endpoint'ler ve referanslar

Bu sayfadaki her veri şuradan alınmıştır: Photta API dokümantasyonu · kontrol edildi

API'yi beş dakikada deneyin

Bir Photta API key oluşturun, yukarıdaki cURL kod parçacığını yapıştırın; kahveniz demlenmeden önce model üzerindeki ilk görselinizi alın.

  • 600 istek/dk
  • Retry-After: 30s
  • asenkron, polling