/document/ thumbs の Turbo Mode の紹介
🤖 /document/thumbs Robotに、新しく Turbo Mode を追加しました。最後にまとめて出力するのではなく、ページサムネイルが準備でき次第出力するため、後続のStepで早く処理を開始できます。これにより、複数ページの PDF の処理全体にかかる時間を短縮できる場合があります。改善の程度はドキュメントとワークフローによって異なります。
Turbo Mode とは?
Turbo Mode では、Transloadit が処理を並列化またはストリーミングすることで、より早く結果を利用できるようになります。まず 🤖 /video/encode と 🤖 /video/concat のRobotに導入し、今回、ドキュメントのサムネイル生成にも同様の利点を取り入れました。仕組みについては、Turbo Mode の FAQをご覧ください。
ドキュメントでの動作
ドキュメントのサムネイル生成では、Turbo Mode がデフォルトで有効です。Turbo Mode を使うと、🤖 /document/thumbs
Robotで各ページの処理が完了し次第、結果を出力できます。結果をまとめて受け取りたい場合は、Stepごとに
turbo を false に設定して無効にできます。
Turbo Mode を有効にしておくと、次のように動作します。
- パイプラインの高速化:後半のページをレンダリングしている間に、後続のStep(画像の後処理や保存など)を開始できます。
- 並列処理:大きなドキュメントではページを並列に抽出し、リサイズ処理を複数のマシンに分散できます。同時実行数や高速化の程度は処理内容によって異なり、ページ数が倍になっても、高速化の程度が倍になるとは限りません。
- ページインデックス:最終結果はページ順に並びますが、処理中は順不同で出力されることがあります。ページのゼロ始まりのインデックスを特定するには、到着順ではなく
meta.thumb_indexを使ってください。最初のページのインデックスは0です。
このストリーミング動作は、ページのプレビューをできるだけ早く表示する必要があるドキュメントビューアーや、「アップロード」から「最初の利用可能なプレビュー」までの時間を少しでも短縮したいパイプラインで特に役立ちます。
適した用途と適さない用途
✅ 時間を重視するワークフロー:最初のプレビューが表示されるまでの時間を短縮したい場合や、後続の処理をページ単位で実行できる場合は、Turbo Mode を選んでください。
❌ コストを重視するワークフロー:Turbo Mode では、使用量の計算時に、抽出したページごとに入力ドキュメントのサイズが加算されます。複数ページのドキュメントでは、料金が大幅に増える可能性があります。レイテンシー短縮の利点とコストを比較し、コストを優先する場合は
turbo を false に設定することを検討してください。単一ページのドキュメントでは、Turbo によるパフォーマンス上の利点も追加料金もありません。turbo パラメーターと料金ドキュメントをご覧ください。
デフォルトで有効になっている理由は?
デフォルトでは、結果を早く取得し、複数ページのワークフローを高速化することを優先しています。ただし、追加コストが伴うため、代表的なドキュメントでレイテンシーと使用量の両方を評価してください。順次処理と結果の一括出力を希望する場合は、turbo を
false にStep内で設定してください。
Assembly の例
以下は、複数ページの PDF を幅 600 ピクセルのページサムネイルに変換し、ファイルパスにインデックスを含めて保存する最小限の例です。Turbo Mode はデフォルトで有効なため、追加のパラメーターは不要です。出力のゼロ始まりの meta.thumb_index は、保存先パスで ${file.meta.thumb_index} として利用できます。
まず、プライベート S3 バケット用の保存済み Template 認証情報を作成し、YOUR_AWS_CREDENTIALS をその名前に置き換えてください。bucket-default によって公開オブジェクト ACL の要求を回避します。バケットポリシーも非公開に保ってください。パスは、セットアップガイドの
uploads/ ポリシープレフィックス配下に収まります。このプレフィックスを変更する場合は、ポリシーとパスをあわせて更新してください。Assembly ID と元のファイル ID により、同じ入力のページをまとめつつ、異なる入力や実行のページを分離します。
{
"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}"
}
}
}
提供状況
ドキュメントのサムネイル生成では、Turbo Mode がデフォルトで有効です。ワークフローの見直しについて支援が必要な場合は、サポートにお問い合わせください。
詳細とお試し
- 🤖 /document/thumbs Robotのドキュメントを参照
- Turbo Mode の FAQを確認
- Transloadit を初めて使う場合は、アカウントを作成して数分で処理を開始
適切にご活用ください!
