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á disponible actualmente solo para planes Enterprise. Solicite acceso aquí si no es un usuario Enterprise pero está interesado en usar la API.

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	Devuelto cuando faltan parámetros de consulta requeridos en la solicitud de URL de carga.
400	invalid_request_error	Falta job_id	Devuelto cuando la solicitud de renderizado 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 array 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	invalid_request_error	video_category no válido. Valores permitidos: podcast, deportes de balón, deportes sin balón, demostración de producto de belleza, boda, viaje, otros	Devuelto cuando `video_category` no es compatible.
400	invalid_request_error	aspect_ratio no válido. Valores permitidos: cuadrado, retrato, paisaje	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 negativo.
400	invalid_request_error	No se pudo determinar la 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 cargadas.
401	authentication_error	Falta la clave de API	Devuelto cuando no se proporciona el encabezado `x-api-key`.
401	authentication_error	Clave de API no válida	Devuelto cuando la clave de 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 procesamiento o renderizado.
403	permission_error	No tiene permiso para acceder a este trabajo	Devuelto cuando el usuario autenticado no es dueño del trabajo solicitado.
403	permission_error	No tiene permiso para renderizar este trabajo	Devuelto cuando el usuario autenticado no es dueño 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 excede la tasa de solicitudes permitida para el punto final. El límite actual es de 60 solicitudes por minuto. La limitación de tasa se aplica principalmente por clave de API usando el encabezado x-api-key, y vuelve a la dirección IP del cliente cuando no se presenta una clave de 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 de tasa.
500	api_error	Error de autenticación	Devuelto cuando la autenticación de la clave de API falla inesperadamente en el servidor.
500	api_error	Error interno del servidor	Devuelto por fallos inesperados del lado del servidor en los puntos finales de estado, renderizado 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.