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_slugmåste finnas i video modell matris.aspect_ratioochduration_secondsmåste matcha modellalternativ exakt.quality_modekrävs när en modell har förinställda kvalitetsinställningar.- Hailuo 2.3 kräver en
input_image_urlsoch stöder inte två bilder. wan_2_6_v2vkräver eninput_video_urlsinträde.- Kling 3.0 stöder tillval
start_frame_url,end_frame_url, ochelementsmed 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
400eller404utan att fixa förfrågningsdata. - Försök inte igen
402tills kontot har tillräckligt med krediter. - Försök igen
429med 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.