Referanse · Rate limits

Photta API rate limits og hvordan polle hensynsfullt

I én setning

Photta API tillater 600 forespørsler per minutt per API-nøkkel i et fast vindu. En 429 inneholder Retry-After: 30. Gjør polling mot en jobb hvert 3. sekund; samtidig arbeid er begrenset av planen.

Få en API-nøkkelLes dokumentasjonen
  • Grenser: 600 forespørsler/min
  • Retry-After: Retry-After: 30s
  • Prosessering: asynkron, polling

Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert

De publiserte grensene

Hastighet, vindu, nytt forsøk, bildestørrelse og formater, slik dokumentasjonen oppgir dem.

Grenser

  • 600 forespørsler per minutt per API-nøkkel (Fast tidsvindu; grensen er lik for alle abonnementer)
  • En 429 inneholder Retry-After: 30 sekunder
  • Opptil 10 MB per bilde
  • Formater: JPEG, PNG, WebP
  • Samtidige batcher per abonnement: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
  • Kun polling – API-et sender ikke webhooks.

Samtidig arbeid etter plan

Hvor mange batcher som kan kjøre samtidig før en innsending returnerer 409.

Kjørende batcher per plan

Free

Samtidige: 1

Hobby

Samtidige: 2

Seller

Samtidige: 3

Brand

Samtidige: 4

Studio

Samtidige: 6

Hold deg innenfor grensene

  • Et fast vindu

    Grensen telles per API-nøkkel i et fast vindu, og den er den samme på hver plan. To nøkler betyr to budsjetter.

  • Poll hvert 3. sekund

    Polling er det eneste signalet på fullføring — API-et sender ingen webhooks. Hvert 3. sekund er det dokumenterte intervallet; raskere polling bruker opp budsjettet ditt på tomme svar.

  • Bruk eksponensiell backoff

    Etter en 429-feil, vent antall sekunder angitt i Retry-After, og øk deretter intervallet for hver påfølgende feil i stedet for å prøve på nytt med en fast frekvens.

  • Batcher har egne begrensninger

    Rate limit teller forespørsler; samtidighetsgrensen teller pågående jobber. En batch som overskrider grensen returnerer 409, ikke 429.

Spørsmål om rate limits

Hva er gjeldende rate limit?

600 forespørsler per minutt per API-nøkkel, i et fast vindu. Dokumentasjonen oppgir det samme tallet for hvert endpoint.

Hvor ofte bør jeg polle en jobb?

Hvert 3. sekund. Det finnes ingen webhooks, så polling er den dokumenterte måten å sjekke om en jobb er fullført.

Hvor mye kan gjengis samtidig?

Pågående batcher er begrenset av abonnement: Free 1, Hobby 2, Seller 3, Brand 4 og Studio 6. Overskrides grensen, returnerer innsendingen 409.

Hva bør jeg gjøre ved en 429-feil?

Les Retry-After-headeren, vent så mange sekunder, og prøv deretter på nytt med eksponensiell backoff. Sett arbeidet i kø i stedet for å forkaste det.

Endepunkter og referanser

Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert

Prøv API-et på fem minutter

Generer en Photta API-nøkkel, lim inn cURL-kodesnutten ovenfor, og du har ditt første bilde på modell før kaffen er ferdig traktet.

Opprett en konto og få en API-nøkkelAPI
  • 600 forespørsler/min
  • Retry-After: 30s
  • asynkron, polling