Sari la conținut
UlazAI

UlazAI documente pentru dezvoltatori

Erori și limite video

Prețuri Bord Studio de imagine

Limite de validare și integrare

Implementați validarea clientului înainte de a trimite cereri. Cele mai multe eșecuri vin din combinații de modele nevalide (durată, raport, calitate sau tip de intrare).

Răspunsuri HTTP comune

Cod Înțeles Cauza tipică
400 Solicitare nevalidă Raport/durată/calitate neacceptat, prompt lipsă, adresă URL nevalidă
401 Neautorizat Lipsește sesiune sau context de autentificare API
402 Este necesară plata Credite insuficiente pentru lotul de locuri de muncă solicitat
404 Nu a fost găsit Model necunoscut slug sau ID job necunoscut
429 Tarif limitat Limitele de solicitare per utilizator au fost depășite

Aparate specifice modelului

  • model_slug trebuie să existe în matricea modelului video.
  • aspect_ratio şi duration_seconds trebuie să se potrivească exact cu opțiunile de model.
  • quality_mode este necesar atunci când un model are presetări de calitate.
  • Hailuo 2.3 necesită unul input_image_urls intrare și nu acceptă două imagini.
  • wan_2_6_v2v necesită unul input_video_urls intrare.
  • Kling 3.0 acceptă opțional start_frame_url, end_frame_url, și elements cu validare strictă a formei.
  • Dimensiunea lotului este limitată la 4 lucrări per cerere.

Prompt limite de lungime

  • Kling 3.0 și Kling 2.6: 2500 de caractere.
  • Grok Imagine Video: 5000 de caractere.
  • Hailuo 2.3 Standard/Pro: 5000 de caractere.
  • Cele mai multe modele rămase urmează validarea standard prompt în serviciile de generare.

Limitele ratelor

  • /api/v1/video-studio/generate/: 24 de solicitări POST per utilizator pe oră.
  • Puncte finale ale instrumentului Video Studio: 24 de solicitări POST per utilizator pe oră.
  • Veo 3.1 acțiuni de extindere și de extindere: 48 de solicitări POST per utilizator pe oră.

Reîncercați strategia

  • Nu reîncercați 400 sau 404 fără a stabili datele cererii.
  • Nu reîncercați 402 până când contul are suficiente credite.
  • Reîncercați 429 cu backoff și respectarea limitelor de rată a serverului.
  • Pentru eșecurile tranzitorii, reîncercați numai după verificarea stării curente a lucrării pentru a evita duplicarea.