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 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 menor 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 puede ser mayor de 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 puede ser mayor de 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 no vá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 no vá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 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.
400	invalid_request_error	music_volume debe ser un número entre 0 y 100	Devuelto 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	Devuelto cuando se proporciona `original_audio_volume` pero no es un número válido entre 0 y 100.
400	invalid_request_error	music_category no válido. Valores permitidos: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	Devuelto cuando se proporciona `music_category` pero no coincide con una de las categorías de música soportadas.
401	authentication_error	Falta la clave API	Devuelto cuando no se proporciona la cabecera `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 tienes suficientes créditos para procesar este trabajo	Devuelto cuando la cuenta no tiene suficientes créditos para procesar o renderizar.
403	permission_error	No tienes permiso para acceder a este trabajo	Devuelto cuando el usuario autenticado no es propietario del trabajo solicitado.
403	permission_error	No tienes 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 excede la tasa de solicitudes permitida para el endpoint. El límite actual es de 60 solicitudes por minuto. El limitador de tasa se aplica principalmente por clave API usando la cabecera 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 deberían reducir la frecuencia de solicitudes y reintentar después de que se restablezca la ventana de limitación 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.	Devuelto 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 emparejar cada job_id en servidores ocupados y las 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	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 de estado, renderizado o resumen de destacados.
500	server_error	No se pudo generar la URL de carga	Devuelto cuando el servidor no puede generar una URL de carga firmada.