Saltar al contenido
UlazAI

Documentos para desarrolladores UlazAI

Errores y límites de vídeo

Precios Panel estudio de imagen

Límites de validación e integración

Aplique la validación del lado del cliente antes de enviar solicitudes. La mayoría de los fracasos vienen de combinaciones de modelos no válidas (duración, relación, calidad o tipo de entrada).

Respuestas HTTP comunes

Código Significado Causa típica
400 Solicitud no válida Proporción/duración/calidad no admitidas, falta prompt, URL no válida
401 No autorizado Falta sesión o contexto de autenticación API
402 Pago requerido Créditos insuficientes para el lote de trabajo solicitado
404 No encontrado Modelo desconocido o ID de trabajo desconocido
429 Tarifa limitada Se superaron los límites de solicitudes por usuario

Protecciones específicas del modelo

  • model_slug debe existir en el matriz de modelo de vídeo.
  • aspect_ratio y duration_seconds debe coincidir exactamente con las opciones del modelo.
  • quality_mode es necesario cuando un modelo tiene ajustes preestablecidos de calidad.
  • Hailuo 2.3 requiere uno input_image_urls entrada y no admite dos imágenes.
  • wan_2_6_v2v requiere uno input_video_urls entrada.
  • Kling 3.0 admite opcional start_frame_url, end_frame_url, y elements con estricta validación de forma.
  • El tamaño del lote tiene un límite de 4 trabajos por solicitud.

Límites de longitud Prompt

  • Kling 3.0 y Kling 2.6: 2500 caracteres.
  • Vídeo Grok Imagine: 5000 caracteres.
  • Hailuo 2.3 Estándar/Pro: 5000 caracteres.
  • La mayoría de los modelos restantes siguen la validación estándar prompt en los servicios de generación.

Límites de tarifas

  • /api/v1/video-studio/generate/: 24 solicitudes POST por usuario por hora.
  • Puntos finales de la herramienta Video Studio: 24 solicitudes POST por usuario por hora.
  • Veo 3.1 ampliar y mejorar acciones: 48 solicitudes POST por usuario por hora.

Estrategia de reintento

  • no lo vuelvas a intentar 400 o 404 sin arreglar los datos de la solicitud.
  • no lo vuelvas a intentar 402 hasta que la cuenta tenga suficientes créditos.
  • Reintentar 429 con retroceso y respetar los límites de velocidad del servidor.
  • En caso de fallas transitorias, vuelva a intentarlo solo después de verificar el estado actual del trabajo para evitar duplicados.