Presentamos el modo Turbo para /document/
Añadimos un nuevo modo Turbo a nuestro Robot 🤖 /document/thumbs. Este genera las miniaturas de las páginas en cuanto están listas, en lugar de agruparlas al final, para que los Steps posteriores puedan comenzar antes. Esto puede reducir el tiempo total de procesamiento de los PDF de varias páginas; la mejora depende del documento y del flujo de trabajo.
¿Qué es el modo Turbo?
El modo Turbo permite a Transloadit paralelizar o procesar el trabajo de forma continua para que los resultados estén disponibles antes. Lo incorporamos primero a nuestros Robots 🤖 /video/encode y 🤖 /video/concat, y ahora ofrecemos ventajas similares para la creación de miniaturas de documentos. Consulta nuestras preguntas frecuentes sobre el modo Turbo para saber cómo funciona.
Cómo funciona con los documentos
El modo Turbo está habilitado de forma predeterminada para las miniaturas de documentos. Permite que el
Robot 🤖 /document/thumbs
genere un resultado por cada página en cuanto termina de procesarla. Si prefieres recibir los
resultados por lotes, puedes deshabilitarlo en cada
Step estableciendo turbo en false.
Dejar el modo Turbo habilitado implica lo siguiente:
- Pipelines más rápidos: los Steps posteriores (por ejemplo, de posprocesamiento de imágenes o almacenamiento) pueden comenzar mientras todavía se renderizan las páginas siguientes.
- Trabajo en paralelo: el modo Turbo puede extraer páginas en paralelo de documentos más grandes y distribuir el redimensionamiento entre varias máquinas. La concurrencia disponible y la mejora de velocidad dependen de la carga de trabajo; duplicar el número de páginas no garantiza duplicar la mejora de velocidad.
- Índices de página: los resultados finales se ordenan por página, pero durante el procesamiento
las páginas pueden generarse en otro orden. Usa
meta.thumb_indexen lugar del orden de llegada para identificar el índice de una página, que comienza en cero: la primera página tiene el índice0.
Este comportamiento de procesamiento continuo es especialmente útil para los visores de documentos que necesitan mostrar vistas previas de las páginas lo antes posible, o para los pipelines en los que cada segundo cuenta entre la «subida» y la «primera vista previa utilizable».
Cuándo usarlo (y cuándo no)
✅ Flujos de trabajo sensibles al tiempo: elige el modo Turbo si quieres reducir el tiempo hasta la primera vista previa, o si el trabajo posterior puede ejecutarse por página.
❌ Flujos de trabajo sensibles al costo: el modo Turbo suma el tamaño del documento de entrada por
cada página extraída al calcular el uso. En documentos de varias páginas, esto puede aumentar
considerablemente el cargo. Compara la ventaja en latencia con ese costo y considera establecer
turbo en false cuando el costo sea más importante.
Los documentos de una sola página no obtienen la mejora de rendimiento de Turbo ni generan el cargo
adicional. Consulta el parámetro turbo y la
documentación de precios.
¿Por qué está habilitado de forma predeterminada?
La configuración predeterminada prioriza obtener resultados antes y acelerar los flujos de trabajo
con documentos de varias páginas. Esa ventaja tiene un costo: evalúa tanto la latencia como el uso con
documentos representativos. Establece turbo en false
en el Step cuando prefieras el procesamiento secuencial
y los resultados por lotes.
Ejemplo de Assembly
A continuación se muestra un ejemplo mínimo que convierte un PDF de varias páginas en miniaturas de
600 px de ancho y las almacena con un índice en la ruta del archivo. El modo Turbo está habilitado de
forma predeterminada; no se necesita ningún parámetro adicional. El valor de
meta.thumb_index de la salida, con índice de base cero, está disponible como
${file.meta.thumb_index} en la ruta de almacenamiento.
Primero crea una credencial de Template almacenada para tu bucket privado de S3
y reemplaza YOUR_AWS_CREDENTIALS por su nombre. bucket-default evita
solicitar una ACL pública para el objeto; mantén también privada la política del bucket. La ruta
permanece bajo el prefijo uploads/ de la política de la guía de configuración;
actualiza la política y la ruta juntas si cambias ese prefijo. El ID de la Assembly y el ID del
archivo original agrupan las páginas de una misma entrada y mantienen separadas las distintas
entradas y ejecuciones.
{
"steps": {
"thumbs": {
"use": ":original",
"robot": "/document/thumbs",
"width": 600,
"resize_strategy": "fit"
},
"store": {
"use": "thumbs",
"robot": "/s3/store",
"credentials": "YOUR_AWS_CREDENTIALS",
"acl": "bucket-default",
"path": "uploads/docs/${assembly.id}/${file.original_id}/page-${file.meta.thumb_index}.${file.ext}"
}
}
}
Disponibilidad
El modo Turbo está habilitado de forma predeterminada para las miniaturas de documentos. Contacta con soporte para obtener ayuda al revisar tu flujo de trabajo.
Más información y cómo probarlo
- Lee la documentación del Robot 🤖 /document/thumbs.
- Revisa las preguntas frecuentes sobre el modo Turbo.
- ¿Es tu primera vez con Transloadit? Regístrate y empieza a procesar archivos en minutos.
¡Disfrútalo y úsalo con responsabilidad!