Referanse · Feil

Photta API-feil alle typer og hva du skal gjøre

I én setning

Alle feil fra Photta API returnerer samme struktur: en status, en `error.type`, en melding og en `request_id`. Gjenta 429 etter Retry-After-headeren og 5xx med eksponensiell tilbakeholdelse; rett 400, 401 og 402 i din egen kode.

Få en API-nøkkelLes dokumentasjonen
  • Feil: 7 feiltyper
  • Retry-After: Retry-After: 30s
  • Grenser: 600 forespørsler/min

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

Feiltyper

Den komplette listen som API-dokumentasjonen publiserer.

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.

Strukturen på en feil

Den samme innpakningen på hvert endepunkt, uansett hva som gikk galt.

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

Håndtering av feil

  • Respekter Retry-After

    En 429 inneholder en Retry-After-header. Vent så mange sekunder, og prøv deretter på nytt med eksponensiell backoff — å prøve igjen umiddelbart skyver bare det neste vinduet lenger unna.

  • Feil refunderer credits

    En generering som feiler etter å ha blitt akseptert, refunderer sine credits automatisk, slik at et nytt forsøk ikke belaster dobbelt.

  • Oppgi request-ID-en

    Hver respons inneholder en `request_id`. Loggfør den. Det er den raskeste måten support kan finne én spesifikk feil blant tusenvis.

  • 409 er et køsignal

    En konflikt betyr at grensen for samtidige batcher i planen din er nådd. Gjør polling mot batchen som allerede kjører til den er ferdig, og send deretter inn på nytt — ikke spinn.

Spørsmål om API-feil

Hvordan ser en feil-body ut?

Et `error`-objekt med en `type` og en `message`, sammen med `request_id`. Typen er stabil og maskinlesbar; meldingen er for mennesker og kan endres.

Hvilke feil er verdt å prøve på nytt?

429 etter å ha ventet i antall sekunder angitt i Retry-After, og 5xx med eksponensiell backoff. En 400, 401 eller 402 vil feile på samme måte helt til noe endres på din side.

Hva betyr 402?

`insufficient_credits_error` — kontoen har ikke nok credits for kallet, eller for hele reservasjonen i en batch. Ingenting genereres og ingenting belastes.

Hvordan rapporterer jeg en feil?

Send `request_id`, endepunktet og tidspunktet. Denne trioen identifiserer det nøyaktige kallet; selve bildet trengs ikke for å slå det opp.

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
  • 7 feiltyper
  • Retry-After: 30s
  • 600 forespørsler/min