Przejdź do treści
UlazAI

Dokumentacja programisty UlazAI

Błędy i ograniczenia wideo

Wycena Panel Pracownia obrazu

Granice walidacji i integracji

Wymuś weryfikację po stronie klienta przed wysłaniem żądań. Większość niepowodzeń przychodzi z nieprawidłowych kombinacji modeli (czas trwania, współczynnik, jakość lub typ danych wejściowych).

Typowe odpowiedzi HTTP

Kod Znaczenie Typowa przyczyna
400 Nieprawidłowe żądanie Nieobsługiwany stosunek/czas trwania/jakość, brak prompt, nieprawidłowy adres URL
401 Nieautoryzowane Brak kontekstu uwierzytelniania sesji lub API
402 Wymagana płatność Niewystarczające kredyty dla żądanej partii zadań
404 Nie znaleziono Nieznany błąd modelu lub nieznany identyfikator zadania
429 Cena ograniczona Przekroczono limity żądań na użytkownika

Osłony specyficzne dla modelu

  • model_slug musi istnieć w matryca modelu wideo.
  • aspect_ratio i duration_seconds musi dokładnie pasować do opcji modelu.
  • quality_mode jest wymagane, gdy model ma ustawienia jakości.
  • Hailuo 2.3 tego wymaga input_image_urls wpisu i nie obsługuje dwóch obrazów.
  • wan_2_6_v2v wymaga jednego input_video_urls wpis.
  • Kling 3.0 obsługuje opcjonalne start_frame_url, end_frame_url, i elements ze ścisłą walidacją kształtu.
  • Rozmiar partii jest ograniczony do 4 zadań na żądanie.

Ograniczenia długości Prompt

  • Kling 3.0 i Kling 2.6: 2500 znaków.
  • Grok Imagine Wideo: 5000 znaków.
  • Hailuo 2.3 Standard/Pro: 5000 znaków.
  • Większość pozostałych modeli podlega standardowej walidacji prompt w usługach generowania.

Limity stawek

  • /api/v1/video-studio/generate/: 24 żądania POST na użytkownika na godzinę.
  • Punkty końcowe narzędzia Video Studio: 24 żądania POST na użytkownika na godzinę.
  • Veo 3.1 rozszerza i skaluje działania: 48 żądań POST na użytkownika na godzinę.

Strategia ponów próbę

  • Nie próbuj ponownie 400 lub 404 bez poprawiania danych żądania.
  • Nie próbuj ponownie 402 dopóki na koncie nie będzie wystarczającej liczby kredytów.
  • Spróbuj ponownie 429 z wycofaniem i przestrzeganiem limitów szybkości serwera.
  • W przypadku przejściowych błędów spróbuj ponownie dopiero po sprawdzeniu bieżącego stanu zadania, aby uniknąć duplikatów.