Zum Inhalt springen
UlazAI

UlazAI Entwicklerdokumentation

Videofehler und -grenzen

Preise Armaturenbrett Bildstudio

Validierungs- und Integrationsgrenzen

Erzwingen Sie die clientseitige Validierung, bevor Sie Anfragen senden. Die meisten Misserfolge kommen aus ungültigen Modellkombinationen (Dauer, Verhältnis, Qualität oder Eingabetyp).

Häufige HTTP-Antworten

Code Bedeutung Typische Ursache
400 Ungültige Anfrage Nicht unterstütztes Verhältnis/Dauer/Qualität, fehlender prompt, ungültige URL
401 Nicht autorisiert Fehlende Sitzung oder API-Authentifizierungskontext
402 Zahlung erforderlich Nicht genügend Credits für den angeforderten Auftragsstapel
404 Nicht gefunden Unbekannter Model-Slug oder unbekannte Job-ID
429 Preis begrenzt Die Anforderungslimits pro Benutzer wurden überschritten

Modellspezifische Schutzvorrichtungen

  • model_slug muss in der vorhanden sein Videomodellmatrix.
  • aspect_ratio und duration_seconds muss genau mit den Modelloptionen übereinstimmen.
  • quality_mode ist erforderlich, wenn ein Modell über Qualitätsvoreinstellungen verfügt.
  • Hailuo 2.3 erfordert eines input_image_urls Eintrag und unterstützt keine zwei Bilder.
  • wan_2_6_v2v erfordert einen input_video_urls Eintrag.
  • Kling 3.0 unterstützt optional start_frame_url, end_frame_url, und elements mit strenger Formvalidierung.
  • Die Batchgröße ist auf 4 Jobs pro Anfrage begrenzt.

Prompt Längenbegrenzungen

  • Kling 3.0 und Kling 2.6: 2500 Zeichen.
  • Grok Imagine Video: 5000 Zeichen.
  • Hailuo 2.3 Standard/Pro: 5000 Zeichen.
  • Die meisten verbleibenden Modelle folgen der standardmäßigen prompt-Validierung in den Generierungsdiensten.

Tarifbegrenzungen

  • /api/v1/video-studio/generate/: 24 POST-Anfragen pro Benutzer und Stunde.
  • Endpunkte des Video Studio-Tools: 24 POST-Anfragen pro Benutzer und Stunde.
  • Veo 3.1 Aktionen erweitern und hochskalieren: 48 POST-Anfragen pro Benutzer und Stunde.

Wiederholungsstrategie

  • Versuchen Sie es nicht erneut 400 oder 404 ohne die Anforderungsdaten zu korrigieren.
  • Versuchen Sie es nicht erneut 402 bis das Konto über genügend Guthaben verfügt.
  • Versuchen Sie es noch einmal 429 mit Backoff und Einhaltung der Serverratenbeschränkungen.
  • Versuchen Sie es bei vorübergehenden Fehlern erst erneut, nachdem Sie den aktuellen Auftragsstatus überprüft haben, um Duplikate zu vermeiden.