Siirry sisältöön

UlazAI kehittäjädokumentit

Videon virheet ja rajat

Validointi- ja integrointirajat

Varmista asiakaspuolen vahvistus ennen pyyntöjen lähettämistä. Suurin osa epäonnistumisista tulee virheellisistä malliyhdistelmistä (kesto, suhde, laatu tai syöttötyyppi).

Yleiset HTTP-vastaukset

Koodi Merkitys Tyypillinen syy
400 Virheellinen pyyntö Suhdesuhdetta/kestoa/laatua ei tueta, prompt puuttuu, URL-osoite on virheellinen
401 Luvaton Puuttuva istunto tai API-todennuskonteksti
402 Maksu vaaditaan Riittämättömät krediitit pyydettyä työerää varten
404 Ei löytynyt Tuntematon malli etana tai tuntematon työtunnus
429 Hinta rajoitettu Käyttäjäkohtaiset pyyntörajat ylittyivät

Mallikohtaiset suojat

  • model_slug täytyy olla olemassa videomallimatriisi.
  • aspect_ratio ja duration_seconds on vastattava tarkasti mallivaihtoehtoja.
  • quality_mode vaaditaan, kun mallissa on esiasetukset.
  • Hailuo 2.3 vaatii sellaisen input_image_urls sisääntuloa eikä tue kahta kuvaa.
  • wan_2_6_v2v vaatii yhden input_video_urls sisääntulo.
  • Kling 3.0 tukee valinnaista start_frame_url, end_frame_url, ja elements tiukan muodon vahvistuksen kanssa.
  • Eräkoko on rajoitettu 4 työhön pyyntöä kohti.

Prompt pituusrajoitukset

  • Kling 3.0 ja Kling 2.6: 2500 merkkiä.
  • Grok Imagine -video: 5000 merkkiä.
  • Hailuo 2.3 Standard/Pro: 5000 merkkiä.
  • Suurin osa jäljellä olevista malleista noudattaa standardia prompt-validointia sukupolvipalveluissa.

Hintarajoitukset

  • /api/v1/video-studio/generate/: 24 POST-pyyntöä käyttäjää kohti tunnissa.
  • Video Studio -työkalun päätepisteet: 24 POST-pyyntöä käyttäjää kohti tunnissa.
  • Veo 3.1 laajennus- ja skaalaustoiminnot: 48 POST-pyyntöä käyttäjää kohti tunnissa.

Yritä strategiaa uudelleen

  • Älä yritä uudelleen 400 tai 404 korjaamatta pyyntötietoja.
  • Älä yritä uudelleen 402 kunnes tilillä on tarpeeksi luottoa.
  • Yritä uudelleen 429 perääntymällä ja noudattamalla palvelimen nopeusrajoituksia.
  • Jos kyseessä on ohimenevä vika, yritä uudelleen vasta sen jälkeen, kun olet tarkistanut työn nykyisen tilan päällekkäisyyksien välttämiseksi.