Turbo-Modus für /document/thumbs vorgestellt

Kevin van Zonneveld

Mitgründer · Amsterdam, Niederlande ·

Wir haben einen neuen Turbo-Modus für unseren Robot 🤖 /document/thumbs eingeführt. Er gibt Seiten-Thumbnails aus, sobald sie bereit sind, statt sie am Ende zu bündeln. So können nachgelagerte Steps früher beginnen. Das kann die Gesamtverarbeitungszeit für mehrseitige PDFs verkürzen; die Verbesserung hängt vom Dokument und Workflow ab.

Was ist der Turbo-Modus?

Mit dem Turbo-Modus kann Transloadit Aufgaben parallel oder als Stream verarbeiten, damit Ergebnisse früher verfügbar sind. Wir haben ihn zuerst für unsere Robots 🤖 /video/encode und 🤖 /video/concat eingeführt. Jetzt bieten wir ähnliche Vorteile bei der Erstellung von Dokument-Thumbnails. Wie das funktioniert, erfahren Sie in unseren FAQ zum Turbo-Modus.

So funktioniert es bei Dokumenten

Der Turbo-Modus ist für Dokument-Thumbnails standardmäßig aktiviert. Er ermöglicht dem Robot 🤖 /document/thumbs, für jede Seite ein Ergebnis auszugeben, sobald diese verarbeitet ist. Wenn Sie gebündelte Ergebnisse bevorzugen, können Sie den Turbo-Modus pro Step deaktivieren, indem Sie turbo auf false setzen.

Wenn der Turbo-Modus aktiviert bleibt, bedeutet das:

Schnellere Pipelines: Nachfolgende Steps (etwa zur Bildnachbearbeitung oder Speicherung) können beginnen, während spätere Seiten noch gerendert werden.
Parallele Verarbeitung: Der Turbo-Modus kann bei größeren Dokumenten Seiten parallel extrahieren und Größenänderungen auf mehrere Maschinen verteilen. Die mögliche Parallelität und Beschleunigung hängen von der Arbeitslast ab; doppelt so viele Seiten garantieren keine doppelte Beschleunigung.
Seitenindizes: Die endgültigen Ergebnisse sind nach Seiten sortiert. Während der Verarbeitung können Seiten jedoch in anderer Reihenfolge ausgegeben werden. Verwenden Sie meta.thumb_index statt der Ankunftsreihenfolge, um den bei null beginnenden Index einer Seite zu bestimmen: Die erste Seite hat den Index 0.

Dieses Streaming-Verhalten ist besonders nützlich für Dokumentbetrachter, die Seitenvorschauen möglichst früh anzeigen müssen, oder für Pipelines, in denen zwischen „Upload“ und „erster nutzbarer Vorschau“ jede Sekunde zählt.

Wann ist der Turbo-Modus sinnvoll (und wann nicht)?

✅ Zeitkritische Workflows: Wählen Sie den Turbo-Modus, wenn Sie die Zeit bis zur ersten Vorschau verkürzen möchten oder nachgelagerte Aufgaben pro Seite ausgeführt werden können.

❌ Kostensensible Workflows: Bei der Nutzungsberechnung addiert der Turbo-Modus für jede extrahierte Seite die Größe des Eingabedokuments. Bei mehrseitigen Dokumenten kann das die Gebühren erheblich erhöhen. Wägen Sie den Latenzvorteil gegen diese Kosten ab und erwägen Sie, turbo auf false zu setzen, wenn Kosten wichtiger sind. Bei einseitigen Dokumenten gibt es weder den Leistungsvorteil des Turbo-Modus noch zusätzliche Gebühren. Siehe den Parameter turbo und die Preisdokumentation.

Warum ist der Turbo-Modus standardmäßig aktiviert?

Die Standardeinstellung priorisiert frühere Ergebnisse und schnellere Workflows für mehrseitige Dokumente. Dieser Vorteil hat seinen Preis: Bewerten Sie sowohl Latenz als auch Nutzung anhand repräsentativer Dokumente. Setzen Sie turbo im Step auf false, wenn Sie sequenzielle Verarbeitung und gebündelte Ergebnisse bevorzugen.

Beispiel-Assembly

Das folgende minimale Beispiel wandelt ein mehrseitiges PDF in 600 px breite Seiten-Thumbnails um und speichert sie mit einem Index im Dateipfad. Der Turbo-Modus ist standardmäßig aktiviert; ein zusätzlicher Parameter ist nicht nötig. Der bei null beginnende Index meta.thumb_index der Ausgabe steht im Speicherpfad als ${file.meta.thumb_index} zur Verfügung.

Legen Sie zunächst einen gespeicherten Eintrag mit Template-Zugangsdaten für Ihren privaten S3-Bucket an und ersetzen Sie YOUR_AWS_CREDENTIALS durch den Namen dieses Eintrags. bucket-default verhindert, dass eine öffentliche Objekt-ACL angefordert wird; halten Sie auch die Bucket-Richtlinie privat. Der Pfad bleibt unter dem Richtlinienpräfix uploads/ aus der Einrichtungsanleitung; passen Sie Richtlinie und Pfad gemeinsam an, wenn Sie dieses Präfix ändern. Die Assembly ID und die ID der Originaldatei gruppieren Seiten derselben Eingabe und trennen sie zugleich von anderen Eingaben und Ausführungen.

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

Verfügbarkeit

Der Turbo-Modus für Dokument-Thumbnails ist standardmäßig aktiviert. Kontaktieren Sie den Support, wenn Sie Hilfe bei der Überprüfung Ihres Workflows benötigen.

Mehr erfahren und ausprobieren

Lesen Sie die Dokumentation zum Robot 🤖 /document/thumbs.
Sehen Sie sich die FAQ zum Turbo-Modus an.
Neu bei Transloadit? Registrieren Sie sich und beginnen Sie innerhalb weniger Minuten mit der Verarbeitung.

Viel Spaß, und nutzen Sie die Funktion verantwortungsvoll!