Wir stellen Turbo Mode für /document/thumbs vor
Wir haben einen neuen Turbo Mode für unseren Robot 🤖 /document/thumbs hinzugefügt. Er gibt Seiten-Thumbnails aus, sobald sie fertig sind, statt sie am Ende zu bündeln, sodass nachgelagerte Steps früher mit der Arbeit beginnen können. Dadurch kann sich die Ende-zu-Ende-Zeit für mehrseitige PDFs je nach Workflow um bis zum Zehnfachen verkürzen.
Was ist Turbo Mode?
Mit Turbo Mode kann Transloadit Arbeit parallelisieren oder streamen, sodass Ergebnisse früher verfügbar werden. Wir haben ihn zuerst für unsere Robots 🤖 /video/encode und 🤖 /video/concat eingeführt und bringen ähnliche Vorteile nun zum Erstellen von Dokument-Thumbnails. In unseren FAQ zum Turbo Mode erfahren Sie, wie er funktioniert.
So funktioniert es für Dokumente
Für Dokument-Thumbnails ist Turbo Mode standardmäßig aktiviert. Turbo Mode ermöglicht es dem
Robot 🤖 /document/thumbs, für
jede Seite ein Ergebnis auszugeben, sobald diese Seite verarbeitet wurde. Wenn Sie gebündelte
Ergebnisse bevorzugen, können Sie dies pro Step
deaktivieren, indem Sie turbo: false setzen.
Wenn Sie Turbo Mode aktiviert lassen, bedeutet das:
- Schnellere Pipelines: nachfolgende Steps (zum Beispiel Bildnachbearbeitung oder Speichern) können beginnen, während spätere Seiten noch gerendert werden.
- Deutlich schnellere Größenänderung: wenn Sie
widthund/oderheightangeben, werden extrahierte Seiten parallel auf entfernten Maschinen in der Größe geändert, statt sequenziell auf einer einzelnen Maschine in die Queue eingereiht zu werden (Nebenläufigkeit von 1). Das führt zu einer drastischen Beschleunigung, die linear mit der Anzahl der Seiten skaliert. - Vorhersehbare Reihenfolge: Ergebnisse werden weiterhin nach Seite sortiert. Sie können
außerdem
meta.thumb_indexprüfen, um den Index einer Seite zu ermitteln.
Dieses Streaming-Verhalten ist besonders nützlich für Dokumentenviewer, die Seitenvorschauen so früh wie möglich anzeigen müssen, oder für Pipelines, bei denen jede Sekunde zwischen „Upload“ und „erster nutzbarer Vorschau“ zählt.
Wann Sie ihn einsetzen sollten (und wann nicht)
✅ Zeitkritische Workflows: Wählen Sie Turbo Mode, wenn Sie die schnellstmögliche Zeit bis zur ersten Vorschau erreichen wollen oder wenn nachgelagerte Arbeit pro Seite laufen kann.
❌ Kostensensible Workflows: Bei manchen Preisszenarien kann die frühere Ausgabe pro Seite
ähnlich behandelt werden wie die Verarbeitung mehrerer Eingaben. Wenn Ihr Hauptziel die
Kostenminimierung ist, können Sie erwägen, dies zu deaktivieren, indem Sie
turbo: false setzen. Details finden Sie in unserer
Preisdokumentation.
Warum ist er standardmäßig aktiviert?
Bei unserer Analyse gängiger Setups sind Dokument-Thumbnails klein und günstig im Vergleich zu Video
und anderen Workloads. Turbo standardmäßig zu aktivieren bringt spürbare Latenzvorteile und wirkt
sich auf die meisten Rechnungen nur vernachlässigbar aus. Wenn Kostenminimierung für Sie oberste
Priorität hat, können Sie dies jederzeit deaktivieren, indem Sie turbo auf
false setzen.
Beispiel-Assembly
Nachfolgend ein minimales Beispiel, das ein mehrseitiges PDF in 600 Pixel breite Seiten-Thumbnails
umwandelt und diese mit einem Index im Dateipfad speichert. Turbo Mode ist standardmäßig aktiviert;
ein zusätzlicher Parameter ist nicht nötig. Zum Deaktivieren setzen Sie
turbo: false. Achten Sie auf meta.thumb_index für
seitenbezogene Dateinamen.
{
"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}"
}
}
}
Verfügbarkeit
Turbo Mode für Dokument-Thumbnails ist ab sofort verfügbar und standardmäßig aktiviert. Wenn Sie ihn kontoweit deaktivieren möchten, wenden Sie sich bitte an hello@transloadit.com und wir helfen Ihnen bei der Einrichtung.
Mehr erfahren und ausprobieren
- Lesen Sie die Dokumentation zum Robot 🤖 /document/thumbs.
- Sehen Sie sich die FAQ zum Turbo Mode an.
- Neu bei Transloadit? Registrieren Sie sich und starten Sie in wenigen Minuten mit der Verarbeitung.
Viel Freude damit und nutzen Sie ihn verantwortungsvoll!