curl --request POST \
--url https://api.rendi.dev/v1/run-ffmpeg-command \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data @- <<EOF
{
"ffmpeg_command": "-i {{in_1}} -vf \"select='lte(t,60)*gt(trunc(t/10),trunc(prev_t/10))',setpts='PTS*0.025',scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1\" -an -vsync vfr {{out_1}}",
"input_files": {
"in_1": "https://storage.rendi.dev/sample/sample.avi"
},
"max_command_run_seconds": 300,
"metadata": {
"key": "value"
},
"output_files": {
"out_1": "output1.gif"
},
"vcpu_count": 8
}
EOFimport requests
url = "https://api.rendi.dev/v1/run-ffmpeg-command"
payload = {
"ffmpeg_command": "-i {{in_1}} -vf \"select='lte(t,60)*gt(trunc(t/10),trunc(prev_t/10))',setpts='PTS*0.025',scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1\" -an -vsync vfr {{out_1}}",
"input_files": { "in_1": "https://storage.rendi.dev/sample/sample.avi" },
"max_command_run_seconds": 300,
"metadata": { "key": "value" },
"output_files": { "out_1": "output1.gif" },
"vcpu_count": 8
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ffmpeg_command: '-i {{in_1}} -vf "select=\'lte(t,60)*gt(trunc(t/10),trunc(prev_t/10))\',setpts=\'PTS*0.025\',scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1" -an -vsync vfr {{out_1}}',
input_files: {in_1: 'https://storage.rendi.dev/sample/sample.avi'},
max_command_run_seconds: 300,
metadata: {key: 'value'},
output_files: {out_1: 'output1.gif'},
vcpu_count: 8
})
};
fetch('https://api.rendi.dev/v1/run-ffmpeg-command', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.rendi.dev/v1/run-ffmpeg-command",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'ffmpeg_command' => '-i {{in_1}} -vf "select=\'lte(t,60)*gt(trunc(t/10),trunc(prev_t/10))\',setpts=\'PTS*0.025\',scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1" -an -vsync vfr {{out_1}}',
'input_files' => [
'in_1' => 'https://storage.rendi.dev/sample/sample.avi'
],
'max_command_run_seconds' => 300,
'metadata' => [
'key' => 'value'
],
'output_files' => [
'out_1' => 'output1.gif'
],
'vcpu_count' => 8
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.rendi.dev/v1/run-ffmpeg-command"
payload := strings.NewReader("{\n \"ffmpeg_command\": \"-i {{in_1}} -vf \\\"select='lte(t,60)*gt(trunc(t/10),trunc(prev_t/10))',setpts='PTS*0.025',scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1\\\" -an -vsync vfr {{out_1}}\",\n \"input_files\": {\n \"in_1\": \"https://storage.rendi.dev/sample/sample.avi\"\n },\n \"max_command_run_seconds\": 300,\n \"metadata\": {\n \"key\": \"value\"\n },\n \"output_files\": {\n \"out_1\": \"output1.gif\"\n },\n \"vcpu_count\": 8\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.rendi.dev/v1/run-ffmpeg-command")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"ffmpeg_command\": \"-i {{in_1}} -vf \\\"select='lte(t,60)*gt(trunc(t/10),trunc(prev_t/10))',setpts='PTS*0.025',scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1\\\" -an -vsync vfr {{out_1}}\",\n \"input_files\": {\n \"in_1\": \"https://storage.rendi.dev/sample/sample.avi\"\n },\n \"max_command_run_seconds\": 300,\n \"metadata\": {\n \"key\": \"value\"\n },\n \"output_files\": {\n \"out_1\": \"output1.gif\"\n },\n \"vcpu_count\": 8\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rendi.dev/v1/run-ffmpeg-command")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"ffmpeg_command\": \"-i {{in_1}} -vf \\\"select='lte(t,60)*gt(trunc(t/10),trunc(prev_t/10))',setpts='PTS*0.025',scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1\\\" -an -vsync vfr {{out_1}}\",\n \"input_files\": {\n \"in_1\": \"https://storage.rendi.dev/sample/sample.avi\"\n },\n \"max_command_run_seconds\": 300,\n \"metadata\": {\n \"key\": \"value\"\n },\n \"output_files\": {\n \"out_1\": \"output1.gif\"\n },\n \"vcpu_count\": 8\n}"
response = http.request(request)
puts response.read_body{
"command_id": "123e4567-e89b-12d3-a456-426614174000"
}{
"detail": "Invalid authorization key"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Run FFmpeg Command
Submit an FFmpeg command for processing with input and output file specifications.
curl --request POST \
--url https://api.rendi.dev/v1/run-ffmpeg-command \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data @- <<EOF
{
"ffmpeg_command": "-i {{in_1}} -vf \"select='lte(t,60)*gt(trunc(t/10),trunc(prev_t/10))',setpts='PTS*0.025',scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1\" -an -vsync vfr {{out_1}}",
"input_files": {
"in_1": "https://storage.rendi.dev/sample/sample.avi"
},
"max_command_run_seconds": 300,
"metadata": {
"key": "value"
},
"output_files": {
"out_1": "output1.gif"
},
"vcpu_count": 8
}
EOFimport requests
url = "https://api.rendi.dev/v1/run-ffmpeg-command"
payload = {
"ffmpeg_command": "-i {{in_1}} -vf \"select='lte(t,60)*gt(trunc(t/10),trunc(prev_t/10))',setpts='PTS*0.025',scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1\" -an -vsync vfr {{out_1}}",
"input_files": { "in_1": "https://storage.rendi.dev/sample/sample.avi" },
"max_command_run_seconds": 300,
"metadata": { "key": "value" },
"output_files": { "out_1": "output1.gif" },
"vcpu_count": 8
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ffmpeg_command: '-i {{in_1}} -vf "select=\'lte(t,60)*gt(trunc(t/10),trunc(prev_t/10))\',setpts=\'PTS*0.025\',scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1" -an -vsync vfr {{out_1}}',
input_files: {in_1: 'https://storage.rendi.dev/sample/sample.avi'},
max_command_run_seconds: 300,
metadata: {key: 'value'},
output_files: {out_1: 'output1.gif'},
vcpu_count: 8
})
};
fetch('https://api.rendi.dev/v1/run-ffmpeg-command', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.rendi.dev/v1/run-ffmpeg-command",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'ffmpeg_command' => '-i {{in_1}} -vf "select=\'lte(t,60)*gt(trunc(t/10),trunc(prev_t/10))\',setpts=\'PTS*0.025\',scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1" -an -vsync vfr {{out_1}}',
'input_files' => [
'in_1' => 'https://storage.rendi.dev/sample/sample.avi'
],
'max_command_run_seconds' => 300,
'metadata' => [
'key' => 'value'
],
'output_files' => [
'out_1' => 'output1.gif'
],
'vcpu_count' => 8
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.rendi.dev/v1/run-ffmpeg-command"
payload := strings.NewReader("{\n \"ffmpeg_command\": \"-i {{in_1}} -vf \\\"select='lte(t,60)*gt(trunc(t/10),trunc(prev_t/10))',setpts='PTS*0.025',scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1\\\" -an -vsync vfr {{out_1}}\",\n \"input_files\": {\n \"in_1\": \"https://storage.rendi.dev/sample/sample.avi\"\n },\n \"max_command_run_seconds\": 300,\n \"metadata\": {\n \"key\": \"value\"\n },\n \"output_files\": {\n \"out_1\": \"output1.gif\"\n },\n \"vcpu_count\": 8\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.rendi.dev/v1/run-ffmpeg-command")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"ffmpeg_command\": \"-i {{in_1}} -vf \\\"select='lte(t,60)*gt(trunc(t/10),trunc(prev_t/10))',setpts='PTS*0.025',scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1\\\" -an -vsync vfr {{out_1}}\",\n \"input_files\": {\n \"in_1\": \"https://storage.rendi.dev/sample/sample.avi\"\n },\n \"max_command_run_seconds\": 300,\n \"metadata\": {\n \"key\": \"value\"\n },\n \"output_files\": {\n \"out_1\": \"output1.gif\"\n },\n \"vcpu_count\": 8\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rendi.dev/v1/run-ffmpeg-command")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"ffmpeg_command\": \"-i {{in_1}} -vf \\\"select='lte(t,60)*gt(trunc(t/10),trunc(prev_t/10))',setpts='PTS*0.025',scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1\\\" -an -vsync vfr {{out_1}}\",\n \"input_files\": {\n \"in_1\": \"https://storage.rendi.dev/sample/sample.avi\"\n },\n \"max_command_run_seconds\": 300,\n \"metadata\": {\n \"key\": \"value\"\n },\n \"output_files\": {\n \"out_1\": \"output1.gif\"\n },\n \"vcpu_count\": 8\n}"
response = http.request(request)
puts response.read_body{
"command_id": "123e4567-e89b-12d3-a456-426614174000"
}{
"detail": "Invalid authorization key"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}input_files must start with in_ (e.g. in_1, in_video); output keys in output_files must start with out_ (e.g. out_1, out_gif). Reference them as {{in_1}} / {{out_1}} placeholders inside ffmpeg_command.Runtime cap: max_command_run_seconds defaults to 300s (5 minutes). It’s a safety cap that aborts runaway FFmpeg jobs — set it explicitly on longer jobs to match the expected runtime. Maximum depends on your plan.Input URLs: any publicly accessible HTTP/HTTPS URL works — Google Drive share links, Dropbox, public/signed S3/GCS, CDNs.Authorizations
Body
Request model for submitting a single FFmpeg command.
This model allows submitting an FFmpeg command with input and output file specifications. Input file aliases must start with 'in_' and direct to a publicly accessible file, and output file aliases must start with 'out_' and only name a file name to be created.
If you're using an automation platform where curly brackets are used special as characters (like make.com, zapier, or other) add backslashes before the curly brackets, for example, replace {{in_1}} with backslashes and brackets \{\{in_1\}\}.
Dictionary mapping file aliases to their desired output file names, keys are alphanumeric, with underscore allowed, must start with 'out_'.
Show child attributes
Show child attributes
{
"out_1": "output_one.mp4",
"out_2": "output_two.mp4"
}
FFmpeg command string using {{alias}} placeholders for input and output files. Input file keys should start with 'in_' prefix, for example: in_video1. Output file keys should start with 'out_' prefix, for example: out_1. If you're using an automation platform where curly brackets are used special as characters (like make.com, zapier, or other) add backslashes before the curly brackets, for example, replace {{in_1}} with backslashes and brackets \{\{in_1\}\}.
"-i {{in_1}} -i {{in_2}} -filter_complex \"[0:v][1:v]hstack=inputs=2[v]\" -map [v] {{out_1}}"
Dictionary mapping file aliases to their publicly accessible paths, file name should appear in the end of the url, keys are alphanumeric, with underscore allowed, must start with 'in_'. You can use public file urls, google drive, dropbox, rendi stored files, s3 stored files, etc. as long as they are publicly accessible. If not available, input_compressed_folder has to be provided
Show child attributes
Show child attributes
{
"in_1": "https://storage.rendi.dev/sample/big_buck_bunny_720p_5sec_intro.mp4",
"in_2": "https://storage.rendi.dev/sample/big_buck_bunny_720p_5sec_outro.mp4"
}
Maximum allowed runtime in seconds for a single FFmpeg command, the default is 300 seconds
300
Number of virtual CPUs to use for a single ffmpeg command, the default is 8, up to your account's maximum. Multiple commands can run in parallel as long as their total vCPU usage doesn't exceed your quota.
8
Metadata to be stored with the command, useful for webhooks and custom tracking and reporting. Up to 10 key-value pairs; each key and each string value must be at most 512 characters.
Show child attributes
Show child attributes
{ "key": "value" }
If true, the command's output files are placed in private storage and can only be downloaded via a presigned URL (request one by passing presigned_ttl_seconds on the poll endpoint). Not available on free plans.
false
A single compressed zip archive containing input media files. Provide either this field or input_files, but not both. Value should be a publicly accessible URL or a rendi storage URL. This field is only available for single FFmpeg commands, not chained commands.
"https://storage.rendi.dev/sample/playlist_sample.zip"
Response
Successfully submitted FFmpeg command
Response model for command submission.
Contains the unique identifier assigned to the submitted command that can be used to poll for status and retrieve results.
Unique identifier for the submitted command
"123e4567-e89b-12d3-a456-426614174000"
Was this page helpful?