Hopp til innholdet

UlazAI utviklerdokumenter

Videofeil og grenser

Validerings- og integrasjonsgrenser

Håndhev validering på klientsiden før du sender forespørsler. De fleste feilene kommer fra ugyldige modellkombinasjoner (varighet, forhold, kvalitet eller inputtype).

Vanlige HTTP-svar

Kode Mening Typisk årsak
400 Ugyldig forespørsel Ustøttet forhold/varighet/kvalitet, mangler prompt, ugyldig nettadresse
401 Uautorisert Manglende økt eller API autentiseringskontekst
402 Betaling kreves Ikke nok kreditter for forespurt jobbbatch
404 Ikke funnet Ukjent modellsnegl eller ukjent jobb-ID
429 Begrenset pris Forespørsler per bruker er overskredet

Modellspesifikke verner

  • model_slug må eksistere i videomodellmatrise.
  • aspect_ratio og duration_seconds må matche modellalternativene nøyaktig.
  • quality_mode kreves når en modell har forhåndsinnstillinger for kvalitet.
  • Hailuo 2.3 krever en input_image_urls oppføring og støtter ikke to bilder.
  • wan_2_6_v2v krever en input_video_urls oppføring.
  • Kling 3.0 støtter valgfritt start_frame_url, end_frame_url, og elements med streng formvalidering.
  • Batchstørrelse er begrenset til 4 jobber per forespørsel.

Prompt lengdegrenser

  • Kling 3.0 og Kling 2.6: 2500 tegn.
  • Grok Imagine Video: 5000 tegn.
  • Hailuo 2.3 Standard/Pro: 5000 tegn.
  • De fleste gjenværende modeller følger standard prompt-validering i generasjonstjenestene.

Satsgrenser

  • /api/v1/video-studio/generate/: 24 POST-forespørsler per bruker per time.
  • Video Studio-verktøyets endepunkter: 24 POST-forespørsler per bruker per time.
  • Veo 3.1 utvide og oppskalere handlinger: 48 POST-forespørsler per bruker per time.

Prøv strategi på nytt

  • Ikke prøv på nytt 400 eller 404 uten å fikse forespørselsdata.
  • Ikke prøv på nytt 402 til kontoen har nok kreditter.
  • Prøv på nytt 429 med backoff og respekter serverhastighetsgrenser.
  • For forbigående feil, prøv bare på nytt etter å ha kontrollert gjeldende jobbstatus for å unngå duplikater.