Referens · Rate limits

Photta API rate limits och hur man pollar artigt

I en mening

Photta API tillåter 600 förfrågningar per minut per API-nyckel i ett fast fönster. En 429 returnerar Retry-After: 30. Polla ett jobb var 3:e sekund; samtidiga jobb begränsas av abonnemanget.

  • Gränser: 600 requests/min
  • Retry-After: Retry-After: 30s
  • Bearbetning: asynkron, polling

Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad

De publicerade gränserna

Hastighet, fönster, återförsök, bildstorlek och format, så som dokumentationen anger dem.

Gränser

  • 600 anrop per minut per API-nyckel (Fast fönster; gränsen är densamma på alla planer)
  • En 429 innehåller Retry-After: 30 sekunder
  • Upp till 10 MB per bild
  • Format: JPEG, PNG, WebP
  • Samtidiga batcher per plan: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
  • Endast polling — API:et skickar inga webhooks.

Samtidiga jobb per abonnemang

Hur många batchar som kan köras samtidigt innan en inskickning returnerar 409.

Aktiva batchar per abonnemang

Free

Samtidiga: 1

Hobby

Samtidiga: 2

Seller

Samtidiga: 3

Brand

Samtidiga: 4

Studio

Samtidiga: 6

Att hålla sig inom gränserna

  • Ett fast fönster

    Gränsen räknas per API-nyckel i ett fast fönster, och den är densamma för alla abonnemang. Två nycklar innebär två budgetar.

  • Polla var 3:e sekund

    Polling är den enda signalen om slutförande — API:et skickar inga webhooks. Var 3:e sekund är det dokumenterade intervallet; snabbare slösar bara din budget på tomma svar.

  • Backa exponentiellt

    Efter en 429, vänta antalet sekunder i Retry-After och öka sedan intervallet vid varje efterföljande fel i stället för att försöka igen med en fast frekvens.

  • Batcher begränsas separat

    Rate limit räknar anrop; samtidighetsgränsen räknar pågående jobb. En batch som överskrider gränsen returnerar 409, inte 429.

Frågor om rate limits

Vad är rate limit?

600 anrop per minut och API-nyckel, i ett fast fönster. Dokumentationen anger samma siffra för varje endpoint.

Hur ofta bör jag polla ett jobb?

Var 3:e sekund. Det finns inga webhooks, så polling är det dokumenterade sättet att få veta när ett jobb är klart.

Hur mycket kan renderas samtidigt?

Pågående batcher begränsas av planen: Free 1, Hobby 2, Seller 3, Brand 4 och Studio 6. Över gränsen returnerar en inskickad förfrågan 409.

Vad ska jag göra vid en 429?

Läs av Retry-After-headern, vänta så många sekunder och försök sedan igen med exponentiell backoff. Lägg jobbet i kö i stället för att kasta det.

Endpoints och referenser

Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad

Testa API:et på fem minuter

Generera en Photta API-nyckel, klistra in cURL-kodfragmentet ovan, och du har din första bild på en modell innan kaffet har bryggts klart.

  • 600 requests/min
  • Retry-After: 30s
  • asynkron, polling