# Błędy i limity Paqshot

> Limity zapytań, kody błędów i ponawianie w API Paqshot.

## Limity

- Generowanie: 50 obrazów na godzinę.
- Pozostałe zapisy: 500 żądań na 15 minut. Odczyty: 2000 żądań na 15 minut.
- Maksymalny rozmiar żądania: 50 MB, zdjęcie produktu do 10 MB.
- Większe limity ustalamy indywidualnie.

## Kody błędów

| Status | Kiedy | Co zrobić |
|---|---|---|
| 400 | Błędny parametr, np. `Invalid aspect ratio`, za duże zdjęcie, brak zdjęcia, szablonu i promptu | Popraw żądanie zgodnie z komunikatem. |
| 402 | `Insufficient credits` | Plan się wyczerpał. Doładuj obrazy albo zmień plan. |
| 429 | Przekroczony limit zapytań | Odczekaj czas z pola `retryAfter` i ponów. |
| 503 | `Service temporarily unavailable`, `retryable: true` | Model jest przeciążony. Ponów za chwilę. |
| 500 | Błąd generowania lub zapisu obrazu | Sprawdź token i ponów. Jeśli błąd się powtarza, napisz do nas. |

## Format błędu

```json
{
  "success": false,
  "error": "Insufficient credits",
  "message": "You don't have enough credits to generate an image."
}
```

## Ponawianie

Ponawiaj żądania przy kodach 429 i 503, z rosnącym odstępem (np. 5, 10, 20 sekund). Nie ponawiaj przy 400 i 402.