Przejdź do treści
UlazAI

Dokumentacja programisty UlazAI

Błędy i ograniczenia

Wycena Panel Pracownia obrazu

Obsługa błędów i ograniczenia platformy

Użyj strukturalnej obsługi błędów API i zweryfikuj dane wejściowe po stronie klienta, aby je zmniejszyć ponawia próby.

Typowe odpowiedzi HTTP

Kod Znaczenie Typowa przyczyna
400 Nieprawidłowe żądanie Brakuje prompt, nieobsługiwany rozmiar, nieprawidłowe parametry modelu
401 Nieautoryzowane Brakujący lub nieprawidłowy klucz/token sesji API
402 Wymagana płatność Niewystarczająca ilość zakupionych kredytów lub ograniczenie dostępu API
403 Zabronione Punkty końcowe rejestracji/logowania API są celowo wyłączone
404 Nie znaleziono Identyfikator generacji nie jest własnością bieżącego użytkownika lub niezgodności punktu końcowego
500 Błąd serwera Awaria dostawcy nadrzędnego lub przekroczenie limitu czasu sieci

Limity żądań w celu egzekwowania po stronie klienta

  • prompt: maksymalnie 5000 znaków na ujednoliconym punkcie końcowym.
  • image_urls: maksymalnie 14 adresów URL na ujednoliconym punkcie końcowym.
  • size: specyficzny dla modelu, sprawdź względem matryca modelu.
  • quality: wartości specyficzne dla modelu dla Seedream 5 Lite, Nano Banana 2, Ideogram i Qwen.
  • Korzystanie z API wymaga zakupionych kredytów; Kredyty powitalne są dostępne wyłącznie na stronie internetowej.

Strategia ponów próbę

Zalecane zachowanie produkcyjne:

  • Nie próbuj ponownie 400, 401, 402lub 403 bez zmiany danych wejściowych lub uwierzytelnienia.
  • Spróbuj ponownie 500 z wykładniczym wycofywaniem i kluczowaniem idempotencji w warstwie aplikacji.
  • Punkt końcowy stanu sondowania przed uruchomieniem zadań generowania duplikatów.