Import files from web servers
🤖/http/import imports any file that is publicly available via a web URL into Transloadit.
The result of this Robot will carry a field
import_url in their metadata, which references the URL from which they were imported. Further conversion results that use this file will also carry this
import_url field. This allows you to to match conversion results with the original import URL that you used.
This Robot knows to interpret links to files on these services:
- Google Drive
- Google Docs
Instead of downloading the HTML page previewing the file, the actual file itself will be imported.
ignore_errorsArray of Strings / Boolean ⋅ default:
Possible array members are
You might see an error when trying to extract metadata from your imported files. This happens, for example, for files with a size of zero bytes. Including
"meta"in the array will cause the Robot to not stop the import (and the entire Assembly) when that happens.
"import"in the array will ensure the Robot does not cease to function on any import errors either.
To keep backwards compatibility, setting this parameter to
truewill set it to
urlString / Array of Stringsrequired
The URL from which the file to be imported can be retrieved.
You can also specify an array of URLs or a string of
|delimited URLs to import several files at once. Please also check the
url_delimiterparameter for that.
url_delimiterString ⋅ default:
Provides the delimiter that is used to split the URLs in your
headersArray of Strings ⋅ default:
Custom headers to be sent for file import.
This is an empty array by default, such that no additional headers except the necessary ones (e.g. Host) are sent.
force_nameString / Array of Strings / Null ⋅ default:
Custom name for the imported file(s). Defaults to
null, which means the file names are derived from the supplied URL(s).
import_on_errorsArray of Strings ⋅ default:
Setting this to
"meta"will still import the file on metadata extraction errors.
ignore_errorsis similar, it also ignores the error and makes sure the Robot doesn't stop, but it doesn't import the file.
fail_fastBoolean ⋅ default:
Disable the internal retry mechanism, and fail immediately if a resource can't be imported. This can be useful for performance critical applications.
- Add an empty audio track to still video
- Insert an ad into a video at a specific time
- Concatenate two audio files
- Concatenate video files
- Generate a video from an image sequence
- Merge an audio and a video file
- Merge an audio file and an image to generate a video
- Fade effect between concatenated audio tracks
- Add watermark to a song
- Insert cover art into an audio file
- Encode a fade effect between concatenated video files.
- Generate a slideshow from a series of images
Related blog posts
- Adding Support for Audio Encoding November 21, 2011
- Two Small Feature Updates February 11, 2012
- Last Night's Elevated Queue Times March 31, 2012
- Announcing the Assembly Notification System April 8, 2013
- API Updates and jQuery SDK Version 2.3.0 November 29, 2013
- New Robot for Virus Detection July 21, 2015
- Raising prices (for new customers) February 7, 2018
- An introduction to the Subtitle Robot December 6, 2018
- Launching Turbo Mode in public beta November 15, 2018
- Tutorial: Using /video/merge to develop video slideshows June 14, 2019
- Add real-time video uploading to a site without writing code, with Bubble.is and Transloadit August 2, 2019
- Convert Markdown to HTML (and PDF) April 19, 2021
- Let's Build: Spinning Vinyl GIF Generator April 1, 2021
- Fast failing for the /http/import Robot June 1, 2021
- Let's Build: a video from album art October 10, 2021
- Transloadit Milestones of 2021 January 31, 2022
- Let's Build: Reddit video subtitling bot February 10, 2022
- Let's Build: Music Card Generator May 5, 2022