Solucionar problemas de subidas fallidas

Si una subida se detiene o un trabajo de procesamiento termina en Error, esta guía te lleva a través de las causas más comunes.

1. Revisa el panel de estado del trabajo

Abre Subidas → Procesando en la barra lateral. Cada trabajo muestra un estado:

• En cola. Subida terminada; esperando un trabajador.
• Procesando. OCR, estructuración y embedding están ejecutándose.
• Procesado / pendiente de revisión. Esperando revisión antes de publicar.
• Completado. Terminado — el documento está en tu Biblioteca.
• Error. Algo salió mal. Haz clic en la fila para ver un mensaje de error legible.

La razón del fallo casi siempre te dice exactamente qué corregir.

2. Vuelve a subir después de verificar el archivo

La mayoría de los fallos de subida caen en una de estas categorías:

• Formato no compatible. Consulta Formatos de archivo compatibles. Convierte con una herramienta gratuita y reintenta.
• PDF encriptado / protegido con contraseña. Elimina la contraseña (Acrobat, Vista Previa en macOS, o qpdf --decrypt), luego vuelve a subir.
• Archivo corrupto. Abre el archivo localmente primero. Si tu visor de PDF no puede leerlo, Vulgate tampoco puede. Vuelve a exportar desde la fuente.
• PDF vacío o solo imágenes sin contraste. El OCR necesita al menos algo de contenido legible. Aumenta el contraste en una herramienta como Acrobat o Vista Previa, luego reintenta.
• Archivo de audio sin contenido audible. Unos segundos de silencio están bien, pero un archivo completo de silencio fallará.

3. Detenciones del lado del navegador

Si la barra de progreso de Subiendo se queda atascada a mitad de camino:

• Caída de red. Actualiza la página — Vulgate reanuda la subida desde donde se quedó para archivos usando subida multiparte.
• Interferencia de extensión del navegador. Prueba en una ventana de Incógnito / Privada con las extensiones deshabilitadas.
• Proxy corporativo bloqueando el almacenamiento. Vulgate sube archivos a Cloudflare R2 a través de una URL firmada (API compatible con S3); algunos proxies corporativos bloquean el tráfico directo al almacenamiento. Prueba una red diferente o contacta a tu equipo de TI.

4. Límite de gasto alcanzado

Si el trabajo dice Has excedido tu límite de gasto para tu plan, has usado los créditos de procesamiento mensuales de tu plan. Espera hasta el próximo ciclo de facturación, o abre Configuración → Facturación y actualiza a un nivel superior. Consulta Ajustar tu plan.

5. Transcripción de audio específicamente

• Desajuste de idioma. Vulgate detecta automáticamente el idioma; si tu archivo es multilingüe, los resultados pueden sufrir. Divide el archivo por idioma y vuelve a subir.
• Audio silencioso. Verifica que el archivo se reproduzca de forma audible localmente primero.
• Archivo muy largo. Los archivos de más de dos horas a veces agotan el tiempo. Divídelos en fragmentos (ffmpeg -i input.mp3 -f segment -segment_time 3600 -c copy chunk_%03d.mp3) y vuelve a subir.

Consulta Por qué falló la transcripción de audio para una depuración más profunda.

6. ¿Sigues atascado?

Si nada de lo anterior ayuda, envíanos un correo a info@vulgate.ai con:

• El ID del trabajo de la fila fallida (el UUID que se muestra en la tabla de trabajos).
• El nombre del archivo original.
• Una copia del archivo, si puedes compartirlo.

Revisaremos los registros y responderemos en un día hábil.