Présentation du mode Turbo pour /document/thumbs

Kevin van Zonneveld

Cofondateur · Amsterdam, Pays-Bas · Afficher la bio

Nous avons ajouté le mode Turbo à notre Robot 🤖 /document/thumbs. Il émet les miniatures des pages dès qu’elles sont prêtes au lieu de les regrouper à la fin, ce qui permet aux Steps en aval de commencer plus tôt. Cela peut réduire la durée totale du traitement des PDF de plusieurs pages ; le gain dépend du document et du flux de travail.

Qu’est-ce que le mode Turbo ?

Le mode Turbo permet à Transloadit de paralléliser le traitement ou d’en émettre les résultats progressivement pour les rendre disponibles plus tôt. Nous l’avons d’abord proposé pour nos Robots 🤖 /video/encode et 🤖 /video/concat, et nous apportons maintenant des avantages similaires à la création de miniatures de documents. Consultez notre FAQ sur le mode Turbo pour découvrir son fonctionnement.

Fonctionnement pour les documents

Le mode Turbo est activé par défaut pour les miniatures de documents. Il permet au Robot 🤖 /document/thumbs d’émettre un résultat pour chaque page dès qu’elle est traitée. Si vous préférez des résultats regroupés, vous pouvez le désactiver pour chaque Step en définissant turbo sur false.

Laisser le mode Turbo activé a les effets suivants :

• Chaînes de traitement plus rapides : les Steps suivants (par exemple, le post-traitement ou le stockage des images) peuvent commencer alors que les pages suivantes sont encore en cours de rendu.
• Traitement parallèle : le mode Turbo peut extraire les pages en parallèle pour les documents volumineux et répartir le redimensionnement sur plusieurs machines. Le parallélisme disponible et le gain de vitesse dépendent de la charge de travail ; doubler le nombre de pages ne garantit pas un gain de vitesse deux fois supérieur.
• Indices des pages : les résultats finaux sont triés par page, mais les pages peuvent être émises dans le désordre pendant le traitement. Utilisez meta.thumb_index plutôt que l’ordre d’arrivée pour identifier l’indice d’une page, compté à partir de zéro : la première page a pour indice 0.

Cette émission progressive est particulièrement utile pour les visionneuses de documents qui doivent afficher les aperçus des pages dès que possible, ou pour les chaînes de traitement où chaque seconde compte entre le « téléversement » et le « premier aperçu exploitable ».

Quand l’utiliser (et quand l’éviter) ?

✅ Flux de travail sensibles à la latence : choisissez le mode Turbo si vous souhaitez réduire le délai avant le premier aperçu, ou si le traitement en aval peut s’exécuter page par page.

❌ Flux de travail sensibles aux coûts : le mode Turbo ajoute la taille du document d’entrée pour chaque page extraite lors du calcul de l’utilisation. Pour les documents de plusieurs pages, cela peut augmenter considérablement les frais. Comparez le gain de latence à ce coût et envisagez de définir turbo sur false si le coût est prioritaire. Les documents d’une seule page ne bénéficient pas du gain de performance du mode Turbo et n’entraînent pas de frais supplémentaires. Consultez le paramètre turbo et la documentation sur la tarification.

Pourquoi est-il activé par défaut ?

Le réglage par défaut privilégie des résultats disponibles plus tôt et des flux de travail plus rapides pour les documents de plusieurs pages. Ce compromis a un coût : évaluez à la fois la latence et l’utilisation avec des documents représentatifs. Définissez turbo sur false dans le Step si vous préférez un traitement séquentiel et des résultats regroupés.

Exemple d’Assembly

Voici un exemple minimal qui convertit un PDF de plusieurs pages en miniatures de 600 px de large et les stocke avec un indice dans le chemin du fichier. Le mode Turbo est activé par défaut ; aucun paramètre supplémentaire n’est nécessaire. Le champ meta.thumb_index de la sortie, dont la valeur est comptée à partir de zéro, est disponible sous la forme ${file.meta.thumb_index} dans le chemin de stockage.

Créez d’abord un ensemble d’informations d’identification de Template enregistré pour votre bucket S3 privé et remplacez YOUR_AWS_CREDENTIALS par son nom. bucket-default évite de demander une ACL d’objet publique ; conservez également une politique de bucket privée. Le chemin reste sous le préfixe uploads/ de la politique du guide de configuration ; si vous modifiez ce préfixe, mettez à jour la politique et le chemin ensemble. L’identifiant de l’Assembly et l’identifiant du fichier d’origine regroupent les pages d’une même entrée, tout en séparant les différentes entrées et exécutions.

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

Disponibilité

Le mode Turbo pour les miniatures de documents est activé par défaut. Contactez l’assistance pour obtenir de l’aide afin d’examiner votre flux de travail.

En savoir plus et essayer

• Consultez la documentation du Robot 🤖 /document/thumbs.
• Consultez la FAQ sur le mode Turbo.
• Vous découvrez Transloadit ? Inscrivez-vous et commencez à traiter vos fichiers en quelques minutes.

Profitez-en et utilisez-le de manière responsable !