Passer au contenu
UlazAI

Documentation du développeur UlazAI

Erreurs et limites vidéo

Tarifs Tableau de bord Studio d'images

Limites de validation et d’intégration

Appliquez la validation côté client avant d’envoyer des demandes. La plupart des échecs surviennent à partir de combinaisons de modèles non valides (durée, rapport, qualité ou type d'entrée).

Réponses HTTP courantes

Coder Signification Cause typique
400 Demande invalide Rapport/durée/qualité non pris en charge, prompt manquant, URL non valide
401 Non autorisé Session manquante ou contexte d'authentification API
402 Paiement requis Crédits insuffisants pour le lot de travaux demandé
404 Pas trouvé Slug de modèle inconnu ou ID de tâche inconnu
429 Tarif limité Limites de requêtes par utilisateur dépassées

Protections spécifiques au modèle

  • model_slug doit exister dans le matrice de modèle vidéo.
  • aspect_ratio et duration_seconds doit correspondre exactement aux options du modèle.
  • quality_mode est requis lorsqu’un modèle a des préréglages de qualité.
  • Hailuo 2.3 en nécessite un input_image_urls entrée et ne prend pas en charge deux images.
  • wan_2_6_v2v en nécessite un input_video_urls entrée.
  • Kling 3.0 prend en charge en option start_frame_url, end_frame_url, et elements avec une validation de forme stricte.
  • La taille du lot est limitée à 4 tâches par demande.

Limites de longueur Prompt

  • Kling 3.0 et Kling 2.6 : 2 500 caractères.
  • Grok Imagine Vidéo : 5000 caractères.
  • Hailuo 2.3 Standard/Pro : 5000 caractères.
  • La plupart des modèles restants suivent la validation standard prompt dans les services de génération.

Limites de taux

  • /api/v1/video-studio/generate/: 24 requêtes POST par utilisateur et par heure.
  • Points de terminaison de l’outil Video Studio : 24 requêtes POST par utilisateur et par heure.
  • Actions d'extension et de mise à l'échelle Veo 3.1 : 48 requêtes POST par utilisateur et par heure.

Stratégie de nouvelle tentative

  • Ne réessayez pas 400 ou 404 sans corriger les données de la demande.
  • Ne réessayez pas 402 jusqu'à ce que le compte dispose de suffisamment de crédits.
  • Réessayer 429 avec recul et respect des limites de débit du serveur.
  • En cas d'échecs temporaires, réessayez uniquement après avoir vérifié l'état actuel de la tâche pour éviter les doublons.