The /http/import Robot

We are happy to import from whatever storage solution suits you best.
The /http/import
Robot imports any file that is publicly available via a web URL into Transloadit.
Parameters
Name | Type | Default | Description |
---|---|---|---|
url
|
(required) String / Array of Strings | 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_delimiter parameter for that.
|
|
url_delimiter
|
String | "|"
|
Provides the delimiter that is used to split the URLs in your url parameter value.
|
headers
|
Array of Strings | []
|
Custom headers to be sent for file import. This is an empty array by default, such that no additional headers expect the necessary ones (e.g. Host) are sent. |
force_name
|
String / Null | null
|
Custom name for the imported file. Defaults to null , which means the file name is derived from the supplied URL.
|
ignore_errors
|
Boolean | false
|
There might be an error coming up when importing files or trying to extract meta data from them. Setting this to true will cause the Robot to not stop the import (and the entire Assembly) when that happens. This is especially useful when you use an array of URLs for the url parameter and thereby import several files at once.
|
Live demos
Our /http/import Robot can be used in combination
with other Robots, to create powerful workflows unique to your use case.
Here are a few example scenarios, and the required Assembly Instructions to implement them.
You can also try demos of these examples right here, live on our website.
Concatenate two audio files
{
"steps": {
":original": {
"robot": "/upload/handle"
},
"imported_postroll": {
"robot": "/http/import",
"url": "https://demos.transloadit.com/inputs/german-anthem.mp3"
},
"concatenated": {
"use": {"steps":[{"name":":original", "fields":"file", "as":"audio_1"},{"name":"imported_postroll", "as":"audio_2"}]},
"robot": "/audio/concat",
"result": true,
"ffmpeg_stack": "v3.3.3"
},
"exported": {
"use": ["imported_postroll", "concatenated", ":original"],
"robot": "/s3/store",
"credentials": "demo_s3_credentials",
"path": "${unique_prefix}/both-anthems.${file.ext}"
}
}
}
Add watermark to a song
{
"steps": {
":original": {
"robot": "/upload/handle"
},
"audio_imported": {
"robot": "/http/import",
"result": true,
"url": "https://demos.transloadit.com/inputs/powered-by.mp3"
},
"merged": {
"use": {"steps":[{"name":"audio_imported", "as":"audio"},{"name":":original", "as":"audio"}]},
"robot": "/audio/merge",
"result": true,
"preset": "mp3"
},
"exported": {
"use": ["audio_imported", "merged", ":original"],
"robot": "/s3/store",
"credentials": "demo_s3_credentials"
}
}
}
Insert cover art into an audio file
{
"steps": {
":original": {
"robot": "/upload/handle"
},
"imported_image": {
"robot": "/http/import",
"url": "https://demos.transloadit.com/inputs/chameleon.jpg"
},
"inserted_artwork": {
"use": {"steps":[{"name":":original", "as":"audio"},{"name":"imported_image", "as":"image"}],"bundle_steps":true},
"robot": "/audio/artwork",
"method": "insert"
},
"exported": {
"use": ["imported_image", "inserted_artwork", ":original"],
"robot": "/s3/store",
"credentials": "demo_s3_credentials"
}
}
}
Import files over HTTP
{
"steps": {
"imported": {
"robot": "/http/import",
"url": "https://demos.transloadit.com/inputs/chameleon.jpg"
},
"resized": {
"use": ["imported"],
"robot": "/image/resize",
"result": true,
"height": 130,
"imagemagick_stack": "v2.0.3",
"width": 130,
"zoom": false
},
"exported": {
"use": ["imported", "resized"],
"robot": "/s3/store",
"credentials": "demo_s3_credentials"
}
}
}
Concatenate video files
{
"steps": {
":original": {
"robot": "/upload/handle"
},
"preroll_imported": {
"robot": "/http/import",
"result": true,
"url": "https://demos.transloadit.com/inputs/waves10.mp4"
},
"preroll_resized": {
"use": ["preroll_imported"],
"robot": "/video/encode",
"result": true,
"background": "#000000",
"ffmpeg_stack": "v3.3.3",
"height": 270,
"preset": "ipad-high",
"resize_strategy": "pad",
"width": 480
},
"original_resized": {
"use": [":original"],
"robot": "/video/encode",
"result": true,
"background": "#000000",
"ffmpeg_stack": "v3.3.3",
"height": 270,
"preset": "ipad-high",
"resize_strategy": "pad",
"width": 480
},
"concatenated": {
"use": {"steps":[{"name":"original_resized", "as":"video_1"},{"name":"preroll_resized", "as":"video_2"}]},
"robot": "/video/concat",
"result": true,
"ffmpeg_stack": "v3.3.3",
"preset": "ipad-high"
},
"exported": {
"use": ["preroll_imported", "preroll_resized", "original_resized", "concatenated", ":original"],
"robot": "/s3/store",
"credentials": "demo_s3_credentials"
}
}
}
Generate a video from an image sequence
{
"steps": {
":original": {
"robot": "/upload/handle"
},
"imported_chameleon": {
"robot": "/http/import",
"result": true,
"url": "https://demos.transloadit.com/inputs/chameleon.jpg"
},
"imported_prinsengracht": {
"robot": "/http/import",
"result": true,
"url": "https://demos.transloadit.com/inputs/prinsengracht.jpg"
},
"imported_snowflake": {
"robot": "/http/import",
"result": true,
"url": "https://demos.transloadit.com/inputs/desert.jpg"
},
"resized": {
"use": ["imported_chameleon", "imported_prinsengracht", "imported_snowflake"],
"robot": "/image/resize",
"result": true,
"height": 768,
"imagemagick_stack": "v2.0.3",
"resize_strategy": "fit",
"width": 1024,
"zoom": false
},
"merged": {
"use": {"steps":[{"name":":original", "as":"audio"},{"name":"resized", "as":"image"}],"bundle_steps":true},
"robot": "/video/merge",
"result": true,
"duration": 9,
"ffmpeg_stack": "v3.3.3",
"framerate": "1/3",
"preset": "ipad-high",
"resize_strategy": "fit"
},
"exported": {
"use": ["imported_chameleon", "imported_prinsengracht", "imported_snowflake", "resized", "merged", ":original"],
"robot": "/s3/store",
"credentials": "demo_s3_credentials"
}
}
}
Merge an audio and a video file
{
"steps": {
":original": {
"robot": "/upload/handle"
},
"imported_video": {
"robot": "/http/import",
"url": "https://demos.transloadit.com/inputs/big-buck-bunny-10s.mp4"
},
"replaced_audio_track": {
"use": [{"name":":original", "as":"audio"},{"name":"imported_video", "as":"video"}],
"robot": "/video/merge",
"result": true,
"ffmpeg_stack": "v3.3.3",
"preset": "iphone-high"
},
"exported": {
"use": ["imported_video", "replaced_audio_track", ":original"],
"robot": "/s3/store",
"credentials": "demo_s3_credentials"
}
}
}
Merge an audio file and an image to generate a video
{
"steps": {
":original": {
"robot": "/upload/handle"
},
"imported_image": {
"robot": "/http/import",
"url": "https://demos.transloadit.com/inputs/chameleon.jpg"
},
"resized_image": {
"use": ["imported_image"],
"robot": "/image/resize",
"result": true,
"height": 768,
"imagemagick_stack": "v2.0.3",
"resize_strategy": "fit",
"width": 1024,
"zoom": false
},
"merged": {
"use": {"steps":[{"name":":original", "as":"audio"},{"name":"resized_image", "as":"image"}]},
"robot": "/video/merge",
"result": true,
"ffmpeg_stack": "v3.3.3",
"preset": "ipad-high",
"resize_strategy": "pad"
},
"exported": {
"use": ["imported_image", "resized_image", "merged", ":original"],
"robot": "/s3/store",
"credentials": "demo_s3_credentials"
}
}
}
Blog posts about our /http/import Robot
Over the years, we wrote the following posts about our /http/import Robot on our blog:
- Two Small Feature Updates February 11, 2012
- Adding Support for Audio Encoding November 21, 2011
Did you know?
You can easily combine Robots to create powerful workflows, unique to your business.
This is the power of Transloadit.