Hoppa till innehållet

UlazAI utvecklardokument

Videofel och gränser

Validerings- och integrationsgränser

Framtvinga validering på klientsidan innan du skickar förfrågningar. De flesta misslyckanden kommer från ogiltiga modellkombinationer (varaktighet, förhållande, kvalitet eller inmatningstyp).

Vanliga HTTP-svar

Kod Mening Typisk orsak
400 Ogiltig begäran Förhållande/varaktighet/kvalitet stöds inte, saknar prompt, ogiltig webbadress
401 Obehörig Saknar session eller API autentiseringskontext
402 Betalning krävs Otillräckliga krediter för begärd jobbbatch
404 Hittade inte Okänd modellsnigel eller okänt jobb-ID
429 Begränsat pris Begäran per användare har överskridits

Modellspecifika skydd

  • model_slug måste finnas i video modell matris.
  • aspect_ratio och duration_seconds måste matcha modellalternativ exakt.
  • quality_mode krävs när en modell har förinställda kvalitetsinställningar.
  • Hailuo 2.3 kräver en input_image_urls och stöder inte två bilder.
  • wan_2_6_v2v kräver en input_video_urls inträde.
  • Kling 3.0 stöder tillval start_frame_url, end_frame_url, och elements med strikt formvalidering.
  • Batchstorleken är begränsad till 4 jobb per begäran.

Prompt längdgränser

  • Kling 3.0 och Kling 2.6: 2500 tecken.
  • Grok Imagine Video: 5000 tecken.
  • Hailuo 2.3 Standard/Pro: 5000 tecken.
  • De flesta återstående modeller följer standard prompt-validering i generationstjänsterna.

Prisgränser

  • /api/v1/video-studio/generate/: 24 POST-förfrågningar per användare och timme.
  • Video Studio-verktygets slutpunkter: 24 POST-förfrågningar per användare och timme.
  • Veo 3.1 utöka och uppskala åtgärder: 48 POST-förfrågningar per användare och timme.

Försök strategi igen

  • Försök inte igen 400 eller 404 utan att fixa förfrågningsdata.
  • Försök inte igen 402 tills kontot har tillräckligt med krediter.
  • Försök igen 429 med backoff och respektera serverhastighetsgränser.
  • För tillfälliga fel, försök endast igen efter att ha kontrollerat aktuell jobbstatus för att undvika dubbletter.