Errores

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

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

Visió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	Devuelto cuando faltan los parámetros de consulta requeridos en la solicitud de URL de carga.
400	invalid_request_error	Falta job_id	Devuelto cuando la solicitud de render no incluye un ID de trabajo.
400	invalid_request_error	No hay salidas disponibles para este trabajo	Devuelto cuando el trabajo no tiene salidas renderizables.
400	invalid_request_error	input_keys debe ser un arreglo no vacío	Devuelto cuando `input_keys` falta o está vacío.
400	invalid_request_error	input_keys debe contener al menos una clave de entrada válida	Devuelto 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 entrada debe ser mayor a 2 segundos	Devuelto 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 entrada debe ser inferior a 6 horas	Devuelto 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	Devuelto 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	Devuelto 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. Valores permitidos: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	Devuelto cuando `video_category` no es compatible.
400	invalid_request_error	aspect_ratio inválido. Valores permitidos: square, portrait, landscape	Devuelto cuando `aspect_ratio` no es compatible.
400	invalid_request_error	output_length debe ser un número positivo	Devuelto 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	Devuelto cuando la API no puede determinar una duración válida para las entradas subidas.
401	authentication_error	Falta la clave API	Devuelto cuando no se proporciona el encabezado `x-api-key`.
401	authentication_error	Clave API inválida	Devuelto cuando la clave API proporcionada no coincide con una clave activa.
402	insufficient_balance	No tiene suficientes créditos para procesar este trabajo	Devuelto cuando la cuenta no tiene suficientes créditos para el procesamiento o la renderización.
403	permission_error	No tiene permiso para acceder a este trabajo	Devuelto cuando el usuario autenticado no es propietario del trabajo solicitado.
403	permission_error	No tiene permiso para renderizar este trabajo	Devuelto cuando el usuario autenticado no es propietario del trabajo que se está renderizando.
404	invalid_request_error	Trabajo no encontrado	Devuelto cuando el trabajo solicitado no existe.
404	invalid_request_error	Usuario no encontrado	Devuelto cuando no se puede encontrar el registro del usuario autenticado.
429	rate_limit_error	Demasiadas solicitudes	Devuelto cuando el cliente supera la tasa de solicitudes permitida para el endpoint. El límite actual es de 60 solicitudes por minuto. La limitación de tasa se aplica principalmente por clave API usando el encabezado `x-api-key`, y recurre a la dirección IP del cliente cuando no se presenta una clave API. Los clientes que alcanzan este límite deben reducir la frecuencia de las solicitudes y reintentar después de que se restablezca la ventana de limitación.
500	api_error	Error de autenticación	Devuelto cuando la autenticación de la clave API falla inesperadamente en el servidor.
500	api_error	Error interno del servidor	Devuelto por fallos inesperados del lado del servidor en los endpoints status, render o highlight reel.
500	server_error	No se pudo generar la URL de carga	Devuelto cuando el servidor no puede generar una URL de carga firmada.