Referentie · Fouten

Photta API-fouten elk type en wat te doen

In één zin

Elke Photta API-fout retourneert dezelfde structuur: een status, een `error.type`, een bericht en een `request_id`. Probeer 429 opnieuw na de Retry-After-header en 5xx met backoff; los 400, 401 en 402 op in je eigen code.

API-sleutel ophalenLees de documentatie
  • Errors: 7 fouttypes
  • Retry-After: Retry-After: 30s
  • Limieten: 600 requests/min

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

Fouttypen

De volledige lijst die de API-documentatie publiceert.

400invalid_request_error
The request is malformed or contains invalid parameters.
401authentication_error
The API key is missing, invalid, or expired.
402insufficient_credits_error
Your account does not have enough credits.
404not_found_error
The requested resource does not exist.
409conflict_error
The request conflicts with current state — e.g. your concurrent-batch cap is reached.
429rate_limit_error
Too many requests. Slow down and retry.Retry-After: 30
500api_error
An internal server error occurred. Retry later.

De structuur van een fout

Dezelfde envelope op elk endpoint, wat er ook misging.

{
  "error": {
    "type": "rate_limit_error",
    "message": "Rate limit exceeded."
  },
  "request_id": "req_xxxxxxxx"
}

Foutafhandeling

  • Respecteer Retry-After

    Een 429 bevat een Retry-After-header. Wacht dat aantal seconden en probeer het vervolgens opnieuw met exponential backoff — direct opnieuw proberen schuift het volgende venster alleen maar verder vooruit.

  • Mislukkingen restitueren credits

    Een generatie die faalt nadat deze is geaccepteerd, restitueert de credits automatisch, zodat een nieuwe poging niet dubbel factureert.

  • Vermeld de request-id

    Elke response bevat een `request_id`. Log deze. Het is voor support de snelste manier om één specifieke fout tussen duizenden terug te vinden.

  • 409 is een wachtrijsignaal

    Een conflict betekent dat de limiet voor gelijktijdige batches van je abonnement is bereikt. Poll de batch die al in behandeling is tot deze klaar is en dien dan pas opnieuw in — ga niet lopen spinnen.

Vragen over API-fouten

Hoe ziet een error-body eruit?

Een `error`-object met een `type` en een `message`, samen met de `request_id`. Het type is stabiel en machineleesbaar; het bericht is voor mensen en kan wijzigen.

Welke fouten zijn de moeite waard om opnieuw te proberen?

429 na het wachten op de Retry-After-seconden, en 5xx met exponential backoff. Een 400, 401 of 402 zal op dezelfde manier blijven falen totdat er aan jouw kant iets verandert.

Wat betekent een 402?

`insufficient_credits_error` — het account heeft niet genoeg credits voor de aanroep, of voor de gehele reservering in een batch. Er wordt niets gegenereerd en niets in rekening gebracht.

Hoe meld ik een fout?

Stuur de `request_id`, het endpoint en het tijdstip mee. Die drie gegevens identificeren exact de aanroep; de afbeelding zelf is niet nodig om deze op te zoeken.

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.

Maak een account aan en haal een API-sleutel opAPI
  • 7 fouttypes
  • Retry-After: 30s
  • 600 requests/min