Apresentando o modo Turbo para /document/thumbs

Kevin van Zonneveld

Cofundador · Amsterdã, Países Baixos · Mostrar biografia

Adicionamos um novo modo Turbo ao nosso Robot 🤖 /document/thumbs. Ele disponibiliza as miniaturas das páginas assim que ficam prontas, em vez de agrupá-las ao final, permitindo que os Steps seguintes comecem a trabalhar mais cedo. Isso pode reduzir o tempo total de processamento de PDFs com várias páginas; a melhoria depende do documento e do fluxo de trabalho.

O que é o modo Turbo?

O modo Turbo permite que a Transloadit paralelize ou processe o trabalho em fluxo para disponibilizar os resultados mais cedo. Nós o introduzimos primeiro nos nossos Robots 🤖 /video/encode e 🤖 /video/concat, e agora estamos trazendo benefícios semelhantes à geração de miniaturas de documentos. Consulte nossas perguntas frequentes sobre o modo Turbo para saber como ele funciona.

Como funciona para documentos

O modo Turbo é habilitado por padrão para miniaturas de documentos. Ele permite que o Robot 🤖 /document/thumbs disponibilize um resultado para cada página assim que ela for processada. Se preferir resultados agrupados, você pode desabilitá-lo em cada Step, definindo turbo como false.

Manter o modo Turbo habilitado significa:

• Pipelines mais rápidos: os Steps seguintes (por exemplo, de pós-processamento ou armazenamento de imagens) podem começar enquanto as páginas posteriores ainda estão sendo renderizadas.
• Trabalho paralelo: o modo Turbo pode extrair páginas em paralelo em documentos maiores e distribuir o redimensionamento entre máquinas. A concorrência disponível e o ganho de velocidade dependem da carga de trabalho; dobrar o número de páginas não garante o dobro do ganho de velocidade.
• Índices das páginas: os resultados finais são ordenados por página, mas as páginas podem ser disponibilizadas fora de ordem durante o processamento. Use meta.thumb_index em vez da ordem de chegada para identificar o índice de base zero de uma página: a primeira página tem índice 0.

Esse comportamento de processamento em fluxo é especialmente útil para visualizadores de documentos que precisam mostrar prévias das páginas o mais cedo possível, ou para pipelines em que cada segundo conta entre o “upload” e a “primeira prévia utilizável”.

Quando usar (e quando não usar)

✅ Fluxos de trabalho sensíveis ao tempo: escolha o modo Turbo se quiser reduzir o tempo até a primeira prévia, ou se o trabalho seguinte puder ser executado por página.

❌ Fluxos de trabalho sensíveis ao custo: ao calcular o uso, o modo Turbo adiciona o tamanho do documento de entrada para cada página extraída. Em documentos com várias páginas, isso pode aumentar consideravelmente a cobrança. Compare o benefício de latência com esse custo e considere definir turbo como false quando o custo for mais importante. Documentos de uma única página não têm o benefício de desempenho do modo Turbo nem a cobrança extra. Consulte o parâmetro turbo e a documentação de preços.

Por que ele é habilitado por padrão?

O padrão prioriza resultados mais cedo e fluxos de trabalho mais rápidos com várias páginas. Essa vantagem tem um custo: avalie tanto a latência quanto o uso com documentos representativos. Defina turbo como false no Step quando preferir processamento sequencial e resultados agrupados.

Exemplo de Assembly

Abaixo está um exemplo mínimo que converte um PDF com várias páginas em miniaturas de páginas com 600 px de largura e as armazena com um índice no caminho do arquivo. O modo Turbo é habilitado por padrão; nenhum parâmetro adicional é necessário. O índice meta.thumb_index da saída começa em zero e fica disponível como ${file.meta.thumb_index} no caminho de armazenamento.

Primeiro, crie uma Credencial de Template armazenada para seu bucket S3 privado e substitua YOUR_AWS_CREDENTIALS pelo nome dela. bucket-default evita solicitar uma ACL pública para o objeto; mantenha a política do bucket privada também. O caminho permanece sob o prefixo uploads/ da política do guia de configuração; atualize a política e o caminho juntos se alterar esse prefixo. O Assembly ID e o ID do arquivo original agrupam as páginas da mesma entrada, separando entradas e execuções diferentes.

{
  "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}"
    }
  }
}

Disponibilidade

O modo Turbo para miniaturas de documentos é habilitado por padrão. Entre em contato com o suporte para obter ajuda na revisão do seu fluxo de trabalho.

Saiba mais e experimente

• Leia a documentação do Robot 🤖 /document/thumbs.
• Consulte as perguntas frequentes sobre o modo Turbo.
• Está começando com a Transloadit? Cadastre-se e comece a processar em minutos.

Aproveite e use com responsabilidade!