Presentamos Turbo Mode para /document/thumbs

Kevin van Zonneveld

Cofundador · Ámsterdam, Países Bajos · Mostrar bio

Añadimos un nuevo Turbo mode a nuestro Robot 🤖 /document/thumbs. Emite las miniaturas de cada página en cuanto están listas, en lugar de agruparlas al final, de modo que los Steps posteriores pueden empezar a trabajar antes. Esto puede reducir hasta diez veces el tiempo de extremo a extremo de los PDF de varias páginas, según tu flujo de trabajo.

¿Qué es Turbo Mode?

Turbo mode permite a Transloadit paralelizar el trabajo o procesarlo en streaming para que los resultados estén disponibles antes. Lo introdujimos primero en nuestros Robots 🤖 /video/encode y 🤖 /video/concat, y ahora llevamos beneficios similares a las miniaturas de documentos. Consulta nuestras preguntas frecuentes sobre Turbo mode para saber cómo funciona.

Cómo funciona con documentos

Turbo mode está activado de forma predeterminada para las miniaturas de documentos. Turbo mode permite que el Robot 🤖 /document/thumbs emita un resultado por cada página en cuanto esa página se procesa. Si prefieres resultados agrupados, puedes desactivarlo en cada Step estableciendo turbo: false.

Dejar Turbo mode activado significa:

• Pipelines más rápidos: los Steps posteriores (por ejemplo, el posprocesamiento de imágenes o el almacenamiento) pueden empezar mientras las páginas siguientes aún se están renderizando.
• Redimensionado mucho más rápido: cuando especificas width y/o height, las páginas extraídas se redimensionan en paralelo en máquinas remotas en lugar de encolarse secuencialmente en una sola máquina (concurrencia de 1). Esto produce una aceleración enorme que escala linealmente con el número de páginas.
• Orden predecible: los resultados siguen ordenados por página. También puedes inspeccionar meta.thumb_index para determinar el índice de una página.

Este comportamiento de streaming resulta especialmente útil para visores de documentos que necesitan mostrar vistas previas de las páginas lo antes posible, o para 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 Turbo mode si quieres el menor tiempo posible hasta la primera vista previa, o si el trabajo posterior puede ejecutarse página por página.

❌ Flujos de trabajo sensibles al costo: en algunos escenarios de precios, la emisión anticipada por página puede tratarse de forma similar al procesamiento de varias entradas. Si tu objetivo principal es minimizar el costo, considera desactivarlo estableciendo turbo: false. Para más detalles, consulta nuestra documentación de precios.

¿Por qué está activado de forma predeterminada?

En nuestro análisis de configuraciones habituales, las miniaturas de documentos son pequeñas y económicas en comparación con el video y otras cargas de trabajo. Activar Turbo de forma predeterminada aporta mejoras notables de latencia y tiene un impacto insignificante en la mayoría de las facturas. Si minimizar el costo es tu máxima prioridad, siempre puedes desactivarlo estableciendo turbo en false.

Ejemplo de Assembly

A continuación tienes un ejemplo mínimo que convierte un PDF de varias páginas en miniaturas de página de 600 píxeles de ancho y las almacena con un índice en la ruta del archivo. Turbo mode está activado de forma predeterminada; no hace falta ningún parámetro adicional. Para desactivarlo, establece turbo: false. Fíjate en meta.thumb_index para obtener nombres de archivo que reflejen la página.

{
  "steps": {
    "thumbs": {
      "use": ":original",
      "robot": "/document/thumbs",
      "width": 600,
      "resize_strategy": "fit"
    },
    "store": {
      "use": "thumbs",
      "robot": "/s3/store",
      "path": "docs/${file.original_basename}/page-${meta.thumb_index}.${file.ext}"
    }
  }
}

Disponibilidad

Turbo mode para las miniaturas de documentos ya está disponible y activado de forma predeterminada. Si quieres desactivarlo en toda tu cuenta, escríbenos a hello@transloadit.com⁠ y te ayudaremos a configurarlo.

Aprende más y pruébalo

• Lee la documentación del Robot 🤖 /document/thumbs.
• Revisa las preguntas frecuentes sobre Turbo mode.
• ¿Nuevo en Transloadit? Regístrate y empieza a procesar en minutos.

¡Disfrútalo y úsalo con responsabilidad!