Errores

La API de VIDIO utiliza un formato de objeto de error consistente. Utilice esta página para entender los tipos de errores comunes, los códigos de estado HTTP y los mensajes de ejemplo devueltos por la API.

El acceso a la API está actualmente disponible para el plan Studio y superior.

Descripción general

Cuando una solicitud falla, la API de VIDIO devuelve un objeto error con un tipo y un mensaje. Algunos errores también pueden incluir campos adicionales para ayudar a explicar la falla.

Formato de error

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "Trabajo no encontrado"
  }
}

Referencia de errores

Status	Type	Message	Description
400	invalid_request_error	Faltan parámetros de consulta requeridos en la solicitud de URL de carga	Se devuelve cuando faltan parámetros de consulta requeridos en la solicitud de URL de carga.
400	invalid_request_error	Falta job_id	Se devuelve cuando la solicitud de render no incluye el ID del trabajo.
400	invalid_request_error	No hay salidas disponibles para este trabajo	Se devuelve cuando el trabajo no tiene salidas que puedan renderizarse.
400	invalid_request_error	input_keys debe ser un arreglo no vacío	Se devuelve cuando `input_keys` no está presente o está vacío.
400	invalid_request_error	input_keys debe contener al menos una clave de entrada válida	Se devuelve cuando todas las claves de entrada proporcionadas están en blanco o son inválidas después de la normalización.
400	input_duration_requirement_error	La duración total de los medios de entrada debe ser mayor a 2 segundos	Se devuelve cuando la duración combinada de todos los medios de entrada es de 2 segundos o menos.
400	input_duration_requirement_error	La duración total de los medios de entrada debe ser menor a 6 horas	Se devuelve cuando la duración combinada de todos los medios de entrada es de 6 horas o más.
400	input_image_count_requirement_error	El número de imágenes de entrada no debe ser mayor a 4000	Se devuelve cuando el número de imágenes de entrada excede el límite máximo permitido de 4000.
400	input_video_count_requirement_error	El número de videos de entrada no debe ser mayor a 400	Se devuelve cuando el número de videos de entrada excede el límite máximo permitido de 400.
400	invalid_request_error	video_category inválido. Allowed values: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	Se devuelve cuando `video_category` no es compatible.
400	invalid_request_error	aspect_ratio inválido. Allowed values: square, portrait, landscape	Se devuelve cuando `aspect_ratio` no es compatible.
400	invalid_request_error	output_length debe ser un número positivo	Se devuelve cuando `output_length` falta, es cero o es negativo.
400	invalid_request_error	No se pudo determinar una duración de entrada positiva a partir de los metadatos de input_keys	Se devuelve cuando la API no puede determinar una duración válida para las entradas cargadas.
400	invalid_request_error	music_volume debe ser un número entre 0 y 100	Se devuelve cuando se proporciona `music_volume` pero no es un número válido entre 0 y 100.
400	invalid_request_error	original_audio_volume debe ser un número entre 0 y 100	Se devuelve cuando se proporciona `original_audio_volume` pero no es un número válido entre 0 y 100.
400	invalid_request_error	music_category inválido. Allowed values: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	Se devuelve cuando se proporciona `music_category` pero no coincide con una de las categorías de música compatibles.
401	authentication_error	Falta la clave API	Se devuelve cuando no se proporciona la cabecera `x-api-key`.
401	authentication_error	Clave API inválida	Se devuelve cuando la clave API proporcionada no coincide con una clave activa.
402	insufficient_balance	No tienes créditos suficientes para procesar este trabajo	Se devuelve cuando la cuenta no tiene suficientes créditos para procesar o renderizar.
403	permission_error	No tienes permiso para acceder a este trabajo	Se devuelve cuando el usuario autenticado no es propietario del trabajo solicitado.
403	permission_error	No tienes permiso para renderizar este trabajo	Se devuelve cuando el usuario autenticado no es propietario del trabajo que se está renderizando.
404	invalid_request_error	Trabajo no encontrado	Se devuelve cuando el trabajo solicitado no existe.
404	invalid_request_error	Usuario no encontrado	Se devuelve cuando no se puede encontrar el registro del usuario autenticado.
429	rate_limit_error	Demasiadas solicitudes	Se devuelve cuando el cliente excede la tasa de solicitudes permitida para el endpoint. El límite actual es de 60 solicitudes por minuto. El límite de tasa se aplica principalmente por clave de API usando el encabezado x-api-key, y recurre a la dirección IP del cliente cuando no hay una clave API presente. Los clientes que alcancen este límite deben reducir la frecuencia de las solicitudes y reintentar después de que se restablezca la ventana del límite de tasa.
429	rate_limit_error	Ya tienes 10 trabajos en ejecución o en cola, que es el máximo permitido. Por favor espera a que algunos trabajos terminen antes de enviar otro.	Se devuelve cuando el usuario ya tiene el número máximo permitido de trabajos en progreso, tanto en ejecución en servidores como pendientes en la cola. El límite actual es de 10 trabajos en ejecución o en cola por usuario. La propiedad se determina al hacer coincidir cada job_id en servidores ocupados y entradas pendientes de la cola con el user_email del trabajo. Los clientes que alcancen este límite deben esperar a que uno o más trabajos existentes se completen antes de crear o renderizar otro trabajo.
500	api_error	Error de autenticación	Se devuelve cuando la autenticación de la clave API falla inesperadamente en el servidor.
500	api_error	Error interno del servidor	Se devuelve por fallas inesperadas del lado del servidor en los endpoints de estado, render o highlight reel.
500	server_error	Error al generar la URL de carga	Se devuelve cuando el servidor no puede generar una URL de carga firmada.