Naar inhoud

UlazAI ontwikkelaarsdocumentatie

Videofouten en limieten

Validatie- en integratielimieten

Dwing validatie aan de clientzijde af voordat u aanvragen verzendt. De meeste mislukkingen komen van ongeldige modelcombinaties (duur, ratio, kwaliteit of invoertype).

Algemene HTTP-reacties

Codeer Betekenis Typische oorzaak
400 Ongeldig verzoek Niet-ondersteunde verhouding/duur/kwaliteit, ontbrekende prompt, ongeldige URL
401 Ongeautoriseerd Ontbrekende sessie of API-authenticatiecontext
402 Betaling vereist Onvoldoende credits voor de aangevraagde taakbatch
404 Niet gevonden Onbekende modelslak of onbekende taak-ID
429 Tarief beperkt Verzoeklimieten per gebruiker overschreden

Modelspecifieke bewakers

  • model_slug moet bestaan in de videomodelmatrix.
  • aspect_ratio en duration_seconds moet exact overeenkomen met de modelopties.
  • quality_mode is vereist wanneer een model kwaliteitsvoorinstellingen heeft.
  • Hailuo 2.3 vereist er één input_image_urls entry en ondersteunt geen twee afbeeldingen.
  • wan_2_6_v2v vereist er één input_video_urls binnenkomst.
  • Kling 3.0 ondersteunt optioneel start_frame_url, end_frame_url, en elements met strikte vormvalidatie.
  • De batchgrootte is beperkt tot 4 taken per aanvraag.

Prompt lengtelimieten

  • Kling 3.0 en Kling 2.6: 2500 tekens.
  • Grok Imagine-video: 5000 tekens.
  • Hailuo 2.3 Standaard/Pro: 5000 tekens.
  • De meeste overige modellen volgen de standaard prompt-validatie in de generatieservices.

Tarieflimieten

  • /api/v1/video-studio/generate/: 24 POST-verzoeken per gebruiker per uur.
  • Eindpunten van de Video Studio-tool: 24 POST-verzoeken per gebruiker per uur.
  • Veo 3.1 acties uitbreiden en opschalen: 48 POST-verzoeken per gebruiker per uur.

Strategie opnieuw proberen

  • Probeer het niet opnieuw 400 of 404 zonder de aanvraaggegevens te corrigeren.
  • Probeer het niet opnieuw 402 totdat het account voldoende credits heeft.
  • Opnieuw proberen 429 met uitstel en respect voor de serversnelheidslimieten.
  • Voor tijdelijke fouten kunt u het alleen opnieuw proberen nadat u de huidige taakstatus hebt gecontroleerd om duplicaten te voorkomen.