Referentie · Rate limits

Photta API rate limits en hoe je beleefd pollt

In één zin

De Photta API staat 600 requests per minuut per API key toe in een vast venster. Een 429 bevat Retry-After: 30. Poll een taak elke 3 seconden; gelijktijdig werk is gemaximeerd per abonnement.

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

Elk getal op deze pagina is afkomstig uit de Photta-API-documentatie · gecontroleerd

De gepubliceerde limieten

Snelheid, venster, opnieuw proberen, afbeeldingsgrootte en formaten, zoals vermeld in de documentatie.

Limieten

  • 600 verzoeken per minuut per API key (Vast venster; de limiet is identiek op elk abonnement)
  • Een 429 bevat Retry-After: 30 seconden
  • Tot 10 MB per afbeelding
  • Formaten: JPEG, PNG, WebP
  • Gelijktijdige batches per abonnement: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
  • Uitsluitend polling — de API stuurt geen webhooks.

Gelijktijdig werk per abonnement

Hoeveel batches er tegelijkertijd in behandeling mogen zijn voordat een verzoek een 409 retourneert.

Batches in behandeling per abonnement

Free

Gelijktijdig: 1

Hobby

Gelijktijdig: 2

Seller

Gelijktijdig: 3

Brand

Gelijktijdig: 4

Studio

Gelijktijdig: 6

Binnen de limieten blijven

  • Een vast venster

    De limiet wordt geteld per API key in een vast venster en is hetzelfde voor elk abonnement. Twee keys betekenen twee budgetten.

  • Poll elke 3 seconden

    Polling is het enige signaal voor voltooiing — de API stuurt geen webhooks. Elke 3 seconden is het gedocumenteerde interval; sneller pollen verspilt je budget aan lege antwoorden.

  • Pas exponential backoff toe

    Wacht na een 429 het aantal seconden uit Retry-After en vergroot vervolgens het interval bij elke volgende fout in plaats van opnieuw te proberen met een vast interval.

  • Batches worden apart gemaximeerd

    De rate limit telt requests; de concurrency cap telt actieve taken. Een batch die de limiet overschrijdt, retourneert 409, geen 429.

Vragen over rate limits

Wat is de rate limit?

600 requests per minuut per API key, in een vast tijdvenster. De documentatie vermeldt hetzelfde cijfer voor elk endpoint.

Hoe vaak moet ik een taak pollen?

Elke 3 seconden. Er zijn geen webhooks, dus polling is de gedocumenteerde manier om te detecteren of een taak is voltooid.

Hoeveel kan er tegelijkertijd renderen?

Het aantal gelijktijdige batches is gemaximeerd per plan: Free 1, Hobby 2, Seller 3, Brand 4 en Studio 6. Boven deze limiet retourneert een aanvraag 409.

Wat moet ik doen bij een 429?

Lees de Retry-After header, wacht dat aantal seconden en probeer het opnieuw met exponential backoff. Plaats het werk in een wachtrij in plaats van het te laten vallen.

Endpoints en referenties

Elk getal op deze pagina is afkomstig uit de Photta-API-documentatie · gecontroleerd

Probeer de API in vijf minuten

Genereer een Photta API-sleutel, plak het bovenstaande cURL-fragment en je hebt je eerste afbeelding op een model voordat de koffie klaar is.

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