UlazAI udviklerdokumenter
Videofejl og begrænsninger
Validerings- og integrationsgrænser
Håndhæv validering på klientsiden, før du sender anmodninger. De fleste fiaskoer kommer fra ugyldige modelkombinationer (varighed, forhold, kvalitet eller inputtype).
Almindelige HTTP-svar
| Kode | Betydning | Typisk årsag |
|---|---|---|
400 |
Ugyldig anmodning | Ikke-understøttet forhold/varighed/kvalitet, manglende prompt, ugyldig URL |
401 |
Uautoriseret | Manglende session eller API-godkendelseskontekst |
402 |
Betaling påkrævet | Utilstrækkelige kreditter til den ønskede jobbatch |
404 |
Ikke fundet | Ukendt modelsnegl eller ukendt job-id |
429 |
Sats begrænset | Grænser for anmodninger pr. bruger er overskredet |
Modelspecifikke afskærmninger
model_slugskal eksistere i video model matrix.aspect_ratioogduration_secondsskal matche model muligheder nøjagtigt.quality_modeer påkrævet, når en model har forudindstillinger af kvalitet.- Hailuo 2.3 kræver en
input_image_urlsindgang og understøtter ikke to billeder. wan_2_6_v2vkræver eninput_video_urlsindgang.- Kling 3.0 understøtter valgfrit
start_frame_url,end_frame_url, ogelementsmed streng formvalidering. - Batchstørrelsen er begrænset til 4 job pr. anmodning.
Prompt længdegrænser
- Kling 3.0 og Kling 2.6: 2500 tegn.
- Grok Imagine Video: 5000 tegn.
- Hailuo 2.3 Standard/Pro: 5000 tegn.
- De fleste resterende modeller følger standard prompt validering i generationstjenesterne.
Satsgrænser
/api/v1/video-studio/generate/: 24 POST-anmodninger pr. bruger pr. time.- Video Studio-værktøjets slutpunkter: 24 POST-anmodninger pr. bruger pr. time.
- Veo 3.1 udvide og opskalere handlinger: 48 POST-anmodninger pr. bruger pr. time.
Prøv strategi igen
- Forsøg ikke igen
400eller404uden at rette anmodningsdata. - Forsøg ikke igen
402indtil kontoen har nok kreditter. - Prøv igen
429med backoff og respekter serverhastighedsgrænser. - For forbigående fejl, prøv kun igen efter at have kontrolleret den aktuelle jobstatus for at undgå dubletter.