Referens · Fel

Photta API-fel alla typer och hur du hanterar dem

I en mening

Varje fel i Photta API returnerar samma struktur: en status, en `error.type`, ett meddelande och ett `request_id`. Gör nytt försök vid 429 efter Retry-After-headern och vid 5xx med backoff; åtgärda 400, 401 och 402 i din egen kod.

Hämta en API-nyckelLäs dokumentationen
  • Fel: 7 feltyper
  • Retry-After: Retry-After: 30s
  • Gränser: 600 requests/min

Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad

Feltyper

Den fullständiga listan som API-dokumentationen publicerar.

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å ett fel

Samma format på varje endpoint, oavsett vad som gick fel.

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

Hantering av fel

  • Respektera Retry-After

    En 429 innehåller en Retry-After-header. Vänta så många sekunder och försök sedan igen med exponentiell backoff — att försöka igen omedelbart skjuter bara nästa fönster längre bort.

  • Misslyckanden återbetalar credits

    En generering som misslyckas efter att ha accepterats återbetalar sina credits automatiskt, så ett nytt försök debiteras inte dubbelt.

  • Ange request-id

    Varje svar innehåller ett `request_id`. Logga det. Det är det snabbaste sättet för supporten att hitta ett specifikt fel bland tusentals.

  • 409 är en kösignal

    En konflikt innebär att ditt abonnemangs gräns för samtidiga batchar har nåtts. Polla batchen som redan körs tills den är klar och skicka sedan in igen — spinn inte runt i onödan.

Frågor om API-fel

Hur ser en fel-body ut?

Ett `error`-objekt med en `type` och ett `message`, tillsammans med `request_id`. Typen är stabil och maskinläsbar; meddelandet är avsett för människor och kan ändras.

Vilka fel är värda att försöka igen på?

429 efter att ha väntat angivna Retry-After-sekunder, samt 5xx med exponentiell backoff. En 400, 401 eller 402 kommer att misslyckas på samma sätt tills något ändras på din sida.

Vad betyder en 402?

`insufficient_credits_error` — kontot har inte tillräckligt med credits för anropet, eller för hela reservationen i en batch. Inget genereras och inget debiteras.

Hur rapporterar jag ett fel?

Skicka `request_id`, endpoint och tidpunkt. Den trippeln identifierar det exakta anropet; själva bilden behövs inte för att slå upp det.

Endpoints och referenser

Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad

Testa API:et på fem minuter

Generera en Photta API-nyckel, klistra in cURL-kodfragmentet ovan, och du har din första bild på en modell innan kaffet har bryggts klart.

Skapa ett konto och hämta en API-nyckelAPI
  • 7 feltyper
  • Retry-After: 30s
  • 600 requests/min