Reference · Rate limits

Photta API rate limits og hvordan du poller høfligt

I én sætning

Photta API tillader 600 requests pr. minut pr. API-nøgle i et fast vindue. En 429 indeholder Retry-After: 30. Poll et job hvert 3. sekund; samtidigt arbejde er begrænset af abonnementet.

  • Grænser: 600 requests/min
  • Retry-After: Retry-After: 30s
  • Behandling: async, polling

Hvert tal på denne side stammer fra Photta API-dokumentationen · tjekket

De offentliggjorte grænser

Hastighed, vindue, genforsøg, billedstørrelse og formater, som dokumentationen angiver dem.

Grænser

  • 600 anmodninger i minuttet pr. API-nøgle (Fast vindue; grænsen er den samme på alle planer)
  • En 429 indeholder Retry-After: 30 sekunder
  • Op til 10 MB pr. billede
  • Formater: JPEG, PNG, WebP
  • Samtidige batches pr. plan: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
  • Kun polling — API'et sender ingen webhooks.

Samtidigt arbejde pr. abonnement

Hvor mange batches der kan være i gang på én gang, før en indsendelse returnerer 409.

Igangværende batches pr. abonnement

Free

Samtidige: 1

Hobby

Samtidige: 2

Seller

Samtidige: 3

Brand

Samtidige: 4

Studio

Samtidige: 6

Hold dig inden for grænserne

  • Et fast vindue

    Grænsen tælles pr. API-nøgle i et fast vindue, og den er den samme på alle abonnementer. To nøgler betyder to budgetter.

  • Poll hvert 3. sekund

    Polling er det eneste signal om fuldførelse — API'et sender ingen webhooks. Hvert 3. sekund er det dokumenterede interval; hurtigere bruger blot dit budget på tomme svar.

  • Eksponentiel backoff

    Efter en 429 skal du vente det antal sekunder, der angives i Retry-After, og derefter øge intervallet ved hver efterfølgende fejl frem for at gentage med en fast frekvens.

  • Batches er begrænset separat

    Rate limit tæller requests; concurrency-grænsen tæller igangværende arbejde. Et batch, der overskrider grænsen, returnerer 409, ikke 429.

Spørgsmål om rate limits

Hvad er rate limit?

600 requests i minuttet pr. API-nøgle i et fast tidsvindue. Dokumentationen angiver den samme figure på hvert endpoint.

Hvor ofte bør jeg polle et job?

Hvert 3. sekund. Der er ingen webhooks, så polling er den dokumenterede metode til at registrere, at et job er fuldført.

Hvor meget kan rendere samtidigt?

Igangværende batches er begrænset af abonnementet: Free 1, Hobby 2, Seller 3, Brand 4 og Studio 6. Overstiges grænsen, returnerer en anmodning 409.

Hvad skal jeg gøre ved en 429?

Læs Retry-After-headeren, vent det angivne antal sekunder, og prøv igen med eksponentiel backoff. Sæt arbejdet i kø frem for at kassere det.

Endpoints og referencer

Hvert tal på denne side stammer fra Photta API-dokumentationen · tjekket

Prøv API'et på fem minutter

Generér en Photta API-nøgle, indsæt cURL-kodestykket ovenfor, og du har dit første billede på en model, før kaffen er færdigbrygget.

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