Błędy

Każdy błąd ma ten sam format:

{ "error": { "code": "limit_exceeded", "message": "Wyczerpany miesięczny limit przymiarek", "details": {} } }

Decyzje podejmuj na podstawie code. message jest po polsku i może się zmienić.

HTTP	code	Znaczenie
401	invalid_api_key	Brak klucza, zły albo unieważniony klucz, albo firma zawieszona
401	invalid_session_token	Token klientki nieważny albo wygasł, pobierz nowy
402	limit_exceeded	Limit miesięczny wyczerpany przy ustawieniu „wstrzymaj” (firmy na umowie)
402	credits_exhausted	Firmie skończyły się kredyty. Gotowe wyniki dalej się otwierają; nowe przymiarki ruszą po zakupie pakietu w panelu
403	shop_disabled	Przymierzalnia wyłączona w butiku
403	live_disabled, previews_disabled	Tryb wyłączony dla firmy
403	previews_not_consented	Klientka nie zgodziła się na zapowiedzi
403	forbidden_key	Plik sylwetki nie należy do tej klientki
404	not_found	Brak zasobu (albo nie należy do Twojej firmy)
404	unknown_product	Nieznany produkt, przekaż go w polu product
409	profile_not_ready	Klientka nie ma gotowej sylwetki
409	tryon_not_ready	Ocenić można tylko przymiarkę w stanie succeeded
422	consent_required	Brak wymaganych zgód
422	invalid_request	Złe dane, szczegóły w details.errors
422	invalid_best_photo	Produkt nie ma zdjęcia o tym numerze
422	unknown_shop	Produkt albo token wskazuje butik, którego nie ma. Załóż go przez PUT /v1/shops/{id}
429	rate_limited	Za dużo zapytań, poczekaj Retry-After sekund
429	customer_limit_exceeded	Klientka wykorzystała dzienny limit nowych przymiarek. details.limit i details.resets_at (północ czasu polskiego). Nie ponawiaj

Błędy przymiarki (error_code)

error_code	Znaczenie
refused	Model odmówił wykonania (np. zdjęcie bielizny)
nsfw_output	Wynik zatrzymany przez filtr treści
garment_unavailable	Produkt nie ma gotowej karty
input_missing	Brak zdjęcia sylwetki albo produktu
budget_exceeded	Generowanie chwilowo wstrzymane po naszej stronie, spróbuj później
inne	Błąd silnika AI, spróbuj ponownie

Nieudane przymiarki i odmowy nie zużywają limitu.