What is Turbo mode?

Turbo Mode is a per-Robot Transloadit setting, controlled by the turbo parameter, that parallelizes supported work to return results sooner. It is opt-in for /video/encode, and on by default for /document/thumbs and /file/decompress.

For video encoding with /video/encode, request Turbo mode with turbo: true; the parameter defaults to false.

Splits the video into multiple chunks so that each chunk can be encoded in parallel before all encoded chunks are stitched back together to form the result video. This comes at the expense of extra Priority Job Slots and may prove to be counter-productive for very small video files.

VP8 output and unresolved video-codec expressions use normal encoding even when turbo is true.

Splitting and joining add overhead, and the available scheduler capacity affects how much work can run in parallel. There is no fixed speedup that applies to every file, codec or Workspace.

The chunk_duration parameter requests the duration of each chunk in seconds. Longer chunks generally produce fewer segment Encoding Jobs, reducing the number that need to run concurrently. When omitted, the encoder selects a chunk duration automatically; do not assume one fixed duration for every input.

This guidance describes /video/encode, not a turbo option for every video Robot. Check your plan’s features and test representative inputs before relying on Turbo mode in a production workflow.