The /video/thumbs Robot
We offer a variety of video encoding features like optimizing for different devices, merging, injecting ads, changing audio tracks, or adding company logos.
The /video/thumbs Robot extracts any number of images from videos for use as previews.
||(required) String / Array of Strings / Object||
GeneralSpecifies which Step(s) to use as our input.
Special Step namesA special Step name is
Providing several Steps as inputYou can add arrays to
That's likely all you need to know about
› Advanced use cases
Step bundlingSome Robots can gather several Step results for a single invocation. For example, the /file/compress Robot would normally create one archive for each file passed to it. If you'd set
This is also a crucial parameter for the /video/adaptive Robot, otherwise you'll generate 1 playlist for each viewing quality.
Keep in mind that all input Steps must be present in your Template. If one of them is missing (for instance it is rejected by a filter), no result is generated because the Robot waits indefinitely for all input Steps to be finished. Here's a demo that showcases Step bundling.
Group by originalSticking with the /file/compress Robot example, you can set
FieldsYou can be more discriminatory by only using files that match a field name by setting the
Use AsSometimes Robots take several inputs. For instance, the /video/merge Robot can create a slideshow from audio and images. You can map different Steps to the appropriate inputs. Example:
Sometimes the ordering is important, for instance, with our concat Robots. In these cases, you can add an index that starts at 1. You can also optionally filter by the multipart field name. Like in this example, where all files are coming from the same source (end-user uploads), but with different
For times when it is not apparent where we should put the file, you can use Assembly Variables to be specific. For instance, you may want to pass a text file to the /image/resize Robot to burn the text in an image, but you are burning multiple texts, so where do we put the text file? We use specify it via
||The number of thumbnails to be extracted. As some videos have incorrect durations, the actual number of thumbnails generated may be less in rare cases. The maximum number of thumbnails we currently allow is 999.|
||Array of Integers / Array of Strings||
||An array of offsets representing seconds of the file duration, such as
||The format of the extracted thumbnail. Supported values are
||Width of the video||The width of the thumbnail, in pixels.|
||Height of the video||The height of the thumbnail, in pixels.|
||One of the available resize strategies.|
||The background color of the resulting thumbnails in the "rrggbbaa" format (red, green, blue, alpha) when used with the
||Integer||Auto||Forces the video to be rotated by the specified degree integer. Currently, only multiples of 90 are supported. We automatically correct the orientation of many videos when the orientation is provided by the camera. This option is only useful for videos requiring rotation because it was not detected by the camera.|
||Selects the FFmpeg stack version to use for encoding.
These versions do not reflect any real
FFmpeg versions, they reflect our own internal (non-semantic)
versioning for our custom FFmpeg builds.
The current recommendation is to use
Our /video/thumbs Robot can be used in combination with other Robots, to create powerful workflows unique to your use case. Here are a few example scenarios that you can try live on our website:
- Automatically process multiple file types
- Convert any video to animated GIF
- Encode a video, extract 8 thumbnails and store everything in an S3 bucket
- Encode video for browsers in 720p
- Extract 10 thumbnails and modify their size
- Make video compatible for all devices
- Save your results to Dropbox
- Specify multiple encoding Steps for a single file
- Use Google Cloud Storage to store your results from Transloadit
Transloadit is a SaaS with a subscription model.
We offer a discount of 90%, effectively counting only every tenth byte of videos that you extract with /video/thumbs. It charges at minimum 0MB whenever it is used. Assuming the Startup Plan and an average video size of 80MB, you could extract 113 videos for $49/month.
Just like with your mobile plan, pricing goes down considerably when you commit to larger monthly volumes. You can adjust this every month. More info and available plans on our Pricing page.
Blog posts about the /video/thumbs Robot
We wrote the following posts about the /video/thumbs Robot on our blog: