Convert - URL
POST {{video-api-server}}/convert/url?output_format=webm
This is a POST request to the Filerobot Video API, designed to convert videos that are publicly available through HTTP protocol.
Use the output_format
query parameter to define the output video format (e.g., webm or mp4).
You can use this endpoint for:
Converting an
avi
file tomp4
for compatibility with mobile devices.Resizing and cropping a video before uploading it to your website.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
output_format | string | Required. Format of the output file | |
crop | string | width,height,x,y |
-
width, height: Size of the crop window
-
x, y: Top-left coordinates to align the crop window's top-left corner (optional, default = 0, 0) | |
resize
| string | | width,height -
Target size of the converted video. If only one value is specified, it is interpreted as height and the aspect ratio is kept. | |
rotate
| number | | Degrees to rotate to: -
Positive values rotate clockwise
-
Negative - counterclockwise |
Request Body
{"0"=>{"url"=>"https://www.pexels.com/download/video/2231485"}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Filerobot-Token | string | Filerobot project identifier, aka token | |
Filerobot-Key | string | Filerobot API key |
RESPONSES
status: OK
{"status":"ok","version":2.11,"result":[{"uuid":"ce59dfa3-6818-4eaf-a4c0-78db56ffb0cb","url":"https://www.pexels.com/download/video/2231485","converted":"https://fbmjmuoeb.filerobot.com/https://filerobot.s3.eu-west-3.amazonaws.com/fbmjmuoeb/converted_videos/xwOBN_2231485/2231485_converted.webm","sha1":"298da7e2e2e6e01764d6aec9802608efce2b49e7","progress":"https://api.filerobot.com/fbmjmuoeb/v4/video-status/ZXUtb3YtNzA2LWdyYTIuZWxhc3RpYy11cGxvYWRlci5haXJzdG9yZS5zY2FsM2ZsM3guY29tOjg3MzI__ce59dfa3-6818-4eaf-a4c0-78db56ffb0cb"}]}