Reference · Fejl

Photta API-fejl alle typer og hvad du gør

I én sætning

Enhver Photta API-fejl returnerer den samme struktur: en status, en `error.type`, en besked og et `request_id`. Forsøg 429 igen efter Retry-After-headeren og 5xx med backoff; ret 400, 401 og 402 i din egen kode.

Hent en API-nøgleLæs dokumentationen
  • Fejl: 7 fejltyper
  • Retry-After: Retry-After: 30s
  • Grænser: 600 requests/min

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

Fejltyper

Den fuldstændige liste, som API-dokumentationen udgiver.

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.

Fejlens struktur

Den samme indkapsling på ethvert endpoint, uanset hvad der gik galt.

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

Håndtering af fejl

  • Respektér Retry-After

    En 429 indeholder en Retry-After-header. Vent det antal sekunder, og prøv igen med eksponentiel backoff — at prøve igen med det samme skubber kun det næste vindue længere væk.

  • Fejl refunderer credits

    En generering, der fejler efter at være blevet accepteret, refunderer automatisk sine credits, så et nyt forsøg ikke trækker betaling to gange.

  • Angiv request id

    Hvert svar indeholder et `request_id`. Log det. Det er den hurtigste måde for support at finde én specifik fejl blandt tusindvis.

  • 409 er et kø-signal

    En konflikt betyder, at dit abonnements grænse for samtidige batches er nået. Poll den batch, der allerede er i gang, indtil den afsluttes, og indsend derefter igen — lav ikke et tight loop.

Spørgsmål om API-fejl

Hvordan ser et error-body ud?

Et `error`-objekt med en `type` og en `message` sammen med `request_id`. Typen er stabil og maskinlæsbar; beskeden er til mennesker og kan ændre sig.

Hvilke fejl er værd at prøve igen?

429 efter at have ventet det antal sekunder, Retry-After angiver, og 5xx med eksponentiel backoff. En 400, 401 eller 402 vil fejle på samme måde, indtil noget ændres på din side.

Hvad betyder 402?

`insufficient_credits_error` — kontoen har ikke nok credits til kaldet eller til hele reservationen i en batch. Intet genereres, og intet opkræves.

Hvordan rapporterer jeg en fejl?

Send `request_id`, endpoint og tidspunkt. Den trio identificerer det nøjagtige kald; selve billedet er ikke nødvendigt for at slå det op.

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.

Opret en konto og hent en API-nøgleAPI
  • 7 fejltyper
  • Retry-After: 30s
  • 600 requests/min