Přejít k obsahu
UlazAI

Dokumenty pro vývojáře UlazAI

Chyby a limity videa

Ceny Dashboard Obrazové studio

Validační a integrační limity

Před odesláním požadavků vynutit ověření na straně klienta. Většina neúspěchů přichází z neplatných kombinací modelů (trvání, poměr, kvalita nebo typ vstupu).

Běžné odpovědi HTTP

kód Význam Typická příčina
400 Neplatný požadavek Nepodporovaný poměr/trvání/kvalita, chybí prompt, neplatná adresa URL
401 Neoprávněný Chybějící relace nebo kontext ověřování API
402 Je vyžadována platba Nedostatek kreditů pro požadovanou pracovní dávku
404 Nenalezeno Neznámý model nebo neznámé ID úlohy
429 Sazba omezená Byly překročeny limity požadavků na uživatele

Ochranné kryty specifické pro daný model

  • model_slug musí existovat v matice video modelu.
  • aspect_ratio a duration_seconds musí přesně odpovídat možnostem modelu.
  • quality_mode je vyžadován, pokud má model předvolby kvality.
  • Hailuo 2.3 vyžaduje jeden input_image_urls záznam a nepodporuje dva obrázky.
  • wan_2_6_v2v vyžaduje jeden input_video_urls vstup.
  • Kling 3.0 podporuje volitelné start_frame_url, end_frame_urla elements s přísnou validací tvaru.
  • Velikost dávky je omezena na 4 úlohy na požadavek.

Omezení délky Prompt

  • Kling 3.0 a Kling 2.6: 2500 znaků.
  • Grok Imagine Video: 5000 znaků.
  • Hailuo 2.3 Standard/Pro: 5000 znaků.
  • Většina zbývajících modelů se ve službách generace řídí standardním ověřením prompt.

Sazbové limity

  • /api/v1/video-studio/generate/: 24 požadavků POST na uživatele za hodinu.
  • Koncové body nástroje Video Studio: 24 požadavků POST na uživatele za hodinu.
  • Akce rozšíření a upgradu Veo 3.1: 48 požadavků POST na uživatele za hodinu.

Zkuste znovu strategii

  • Nezkoušejte to znovu 400 nebo 404 bez opravy dat požadavku.
  • Nezkoušejte to znovu 402 dokud účet nebude mít dostatek kreditů.
  • Zkuste to znovu 429 s couváním a respektováním limitů rychlosti serveru.
  • V případě přechodných selhání to opakujte až po kontrole aktuálního stavu úlohy, abyste předešli duplicitám.