Referencje · Błędy

Błędy Photta API każdy typ i sposób postępowania

W jednym zdaniu

Każdy błąd w Photta API zwraca tę samą strukturę: status, `error.type`, komunikat i `request_id`. Ponawiaj żądania z kodem 429 po upływie wskazanym w nagłówku Retry-After, a błędy 5xx z mechanizmem backoff; kody 400, 401 i 402 naprawiaj bezpośrednio w swoim kodzie.

Pobierz klucz APIPrzeczytaj dokumentację
  • Błędy: 7 typów błędów
  • Retry-After: Retry-After: 30s
  • Limity: 600 requests/min

Każda liczba na tej stronie pochodzi z dokumentacji API Photta · sprawdzono

Typy błędów

Kompletna lista publikowana przez dokumentację API.

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.

Struktura błędu

Ta sama koperta na każdym endpoincie, niezależnie od przyczyny błędu.

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

Obsługa błędów

  • Przestrzegaj Retry-After

    Odpowiedź 429 zawiera nagłówek Retry-After. Odczekaj podaną liczbę sekund, a następnie ponów próbę z wykładniczym wydłużaniem przerw (exponential backoff) — natychmiastowe ponowienie tylko oddala kolejne okno.

  • Błędy zwracają credits

    Generowanie, które zakończy się błędem po zaakceptowaniu, automatycznie zwraca credits, więc ponowna próba nie nalicza opłaty podwójnie.

  • Podawaj request id

    Każda odpowiedź zawiera `request_id`. Loguj go. To najszybszy sposób, aby support odnalazł konkretny błąd wśród tysięcy innych.

  • 409 to sygnał z kolejki

    Konflikt oznacza osiągnięcie limitu współbieżnych batchy dla danego planu. Wykonuj polling batcha będącego w toku, aż zostanie ukończony, a potem wyślij żądanie ponownie — nie odpytuj w pętli bez przerw.

Pytania o błędy API

Jak wygląda treść błędu?

Obiekt `error` z polami `type` i `message`, obok `request_id`. Pole type jest stałe i przeznaczone do parsowania maszynowego; message jest dla ludzi i może ulec zmianie.

Które błędy warto ponawiać?

429 po odczekaniu liczby sekund z Retry-After oraz 5xx z wykładniczym wydłużaniem przerw. Błędy 400, 401 lub 402 zakończą się tak samo, dopóki nie zmienisz czegoś po swojej stronie.

Co oznacza kod 402?

`insufficient_credits_error` — konto nie ma wystarczającej liczby credits na to wywołanie lub na pełną rezerwację w batchu. Nic nie zostanie wygenerowane i żadne opłaty nie zostaną pobrane.

Jak zgłosić błąd?

Prześlij `request_id`, endpoint oraz znacznik czasu. Ta trójka jednoznacznie identyfikuje wywołanie; sam obraz nie jest potrzebny do jego odszukania.

Endpointy i dokumentacja

Każda liczba na tej stronie pochodzi z dokumentacji API Photta · sprawdzono

Wypróbuj API w 5 minut

Wygeneruj klucz Photta API, wklej powyższy snippet cURL, a otrzymasz swoje pierwsze zdjęcie na modelu, zanim zaparzy się kawa.

Załóż konto i pobierz klucz APIAPI
  • 7 typów błędów
  • Retry-After: 30s
  • 600 requests/min