Run Chained FFmpeg Commands which share input and output files
curl --request POST \
--url https://api.rendi.dev/v1/run-chained-ffmpeg-commands \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"ffmpeg_commands": [
"-i {{in_1}} -i {{in_2}} -filter_complex \"[0:v][1:v]hstack=inputs=2[v]\" -map [v] {{out_1}}",
"-i {{out_1}} -vframes 1 {{out_2}}"
],
"input_files": {
"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"
},
"max_command_run_seconds": 300,
"metadata": {
"key": "value"
},
"output_files": {
"out_1": "output_concatenated.mp4",
"out_2": "thumbnail.jpg"
},
"vcpu_count": 8
}
'import requests
url = "https://api.rendi.dev/v1/run-chained-ffmpeg-commands"
payload = {
"ffmpeg_commands": ["-i {{in_1}} -i {{in_2}} -filter_complex \"[0:v][1:v]hstack=inputs=2[v]\" -map [v] {{out_1}}", "-i {{out_1}} -vframes 1 {{out_2}}"],
"input_files": {
"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"
},
"max_command_run_seconds": 300,
"metadata": { "key": "value" },
"output_files": {
"out_1": "output_concatenated.mp4",
"out_2": "thumbnail.jpg"
},
"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_commands: [
'-i {{in_1}} -i {{in_2}} -filter_complex "[0:v][1:v]hstack=inputs=2[v]" -map [v] {{out_1}}',
'-i {{out_1}} -vframes 1 {{out_2}}'
],
input_files: {
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'
},
max_command_run_seconds: 300,
metadata: {key: 'value'},
output_files: {out_1: 'output_concatenated.mp4', out_2: 'thumbnail.jpg'},
vcpu_count: 8
})
};
fetch('https://api.rendi.dev/v1/run-chained-ffmpeg-commands', 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-chained-ffmpeg-commands",
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_commands' => [
'-i {{in_1}} -i {{in_2}} -filter_complex "[0:v][1:v]hstack=inputs=2[v]" -map [v] {{out_1}}',
'-i {{out_1}} -vframes 1 {{out_2}}'
],
'input_files' => [
'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'
],
'max_command_run_seconds' => 300,
'metadata' => [
'key' => 'value'
],
'output_files' => [
'out_1' => 'output_concatenated.mp4',
'out_2' => 'thumbnail.jpg'
],
'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-chained-ffmpeg-commands"
payload := strings.NewReader("{\n \"ffmpeg_commands\": [\n \"-i {{in_1}} -i {{in_2}} -filter_complex \\\"[0:v][1:v]hstack=inputs=2[v]\\\" -map [v] {{out_1}}\",\n \"-i {{out_1}} -vframes 1 {{out_2}}\"\n ],\n \"input_files\": {\n \"in_1\": \"https://storage.rendi.dev/sample/big_buck_bunny_720p_5sec_intro.mp4\",\n \"in_2\": \"https://storage.rendi.dev/sample/big_buck_bunny_720p_5sec_outro.mp4\"\n },\n \"max_command_run_seconds\": 300,\n \"metadata\": {\n \"key\": \"value\"\n },\n \"output_files\": {\n \"out_1\": \"output_concatenated.mp4\",\n \"out_2\": \"thumbnail.jpg\"\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-chained-ffmpeg-commands")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"ffmpeg_commands\": [\n \"-i {{in_1}} -i {{in_2}} -filter_complex \\\"[0:v][1:v]hstack=inputs=2[v]\\\" -map [v] {{out_1}}\",\n \"-i {{out_1}} -vframes 1 {{out_2}}\"\n ],\n \"input_files\": {\n \"in_1\": \"https://storage.rendi.dev/sample/big_buck_bunny_720p_5sec_intro.mp4\",\n \"in_2\": \"https://storage.rendi.dev/sample/big_buck_bunny_720p_5sec_outro.mp4\"\n },\n \"max_command_run_seconds\": 300,\n \"metadata\": {\n \"key\": \"value\"\n },\n \"output_files\": {\n \"out_1\": \"output_concatenated.mp4\",\n \"out_2\": \"thumbnail.jpg\"\n },\n \"vcpu_count\": 8\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rendi.dev/v1/run-chained-ffmpeg-commands")
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_commands\": [\n \"-i {{in_1}} -i {{in_2}} -filter_complex \\\"[0:v][1:v]hstack=inputs=2[v]\\\" -map [v] {{out_1}}\",\n \"-i {{out_1}} -vframes 1 {{out_2}}\"\n ],\n \"input_files\": {\n \"in_1\": \"https://storage.rendi.dev/sample/big_buck_bunny_720p_5sec_intro.mp4\",\n \"in_2\": \"https://storage.rendi.dev/sample/big_buck_bunny_720p_5sec_outro.mp4\"\n },\n \"max_command_run_seconds\": 300,\n \"metadata\": {\n \"key\": \"value\"\n },\n \"output_files\": {\n \"out_1\": \"output_concatenated.mp4\",\n \"out_2\": \"thumbnail.jpg\"\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>"
}
]
}Running FFmpeg
Run Chained FFmpeg Commands
Submit multiple FFmpeg commands where following commands can depend on output of previous commands. Running chained FFmpeg commands is faster than running each command separately because we re-use system and network resources between the multiple ffmpeg commands. Processing quota is shared between the commands, and is more efficient than running each command separately.
POST
/
v1
/
run-chained-ffmpeg-commands
Run Chained FFmpeg Commands which share input and output files
curl --request POST \
--url https://api.rendi.dev/v1/run-chained-ffmpeg-commands \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"ffmpeg_commands": [
"-i {{in_1}} -i {{in_2}} -filter_complex \"[0:v][1:v]hstack=inputs=2[v]\" -map [v] {{out_1}}",
"-i {{out_1}} -vframes 1 {{out_2}}"
],
"input_files": {
"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"
},
"max_command_run_seconds": 300,
"metadata": {
"key": "value"
},
"output_files": {
"out_1": "output_concatenated.mp4",
"out_2": "thumbnail.jpg"
},
"vcpu_count": 8
}
'import requests
url = "https://api.rendi.dev/v1/run-chained-ffmpeg-commands"
payload = {
"ffmpeg_commands": ["-i {{in_1}} -i {{in_2}} -filter_complex \"[0:v][1:v]hstack=inputs=2[v]\" -map [v] {{out_1}}", "-i {{out_1}} -vframes 1 {{out_2}}"],
"input_files": {
"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"
},
"max_command_run_seconds": 300,
"metadata": { "key": "value" },
"output_files": {
"out_1": "output_concatenated.mp4",
"out_2": "thumbnail.jpg"
},
"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_commands: [
'-i {{in_1}} -i {{in_2}} -filter_complex "[0:v][1:v]hstack=inputs=2[v]" -map [v] {{out_1}}',
'-i {{out_1}} -vframes 1 {{out_2}}'
],
input_files: {
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'
},
max_command_run_seconds: 300,
metadata: {key: 'value'},
output_files: {out_1: 'output_concatenated.mp4', out_2: 'thumbnail.jpg'},
vcpu_count: 8
})
};
fetch('https://api.rendi.dev/v1/run-chained-ffmpeg-commands', 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-chained-ffmpeg-commands",
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_commands' => [
'-i {{in_1}} -i {{in_2}} -filter_complex "[0:v][1:v]hstack=inputs=2[v]" -map [v] {{out_1}}',
'-i {{out_1}} -vframes 1 {{out_2}}'
],
'input_files' => [
'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'
],
'max_command_run_seconds' => 300,
'metadata' => [
'key' => 'value'
],
'output_files' => [
'out_1' => 'output_concatenated.mp4',
'out_2' => 'thumbnail.jpg'
],
'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-chained-ffmpeg-commands"
payload := strings.NewReader("{\n \"ffmpeg_commands\": [\n \"-i {{in_1}} -i {{in_2}} -filter_complex \\\"[0:v][1:v]hstack=inputs=2[v]\\\" -map [v] {{out_1}}\",\n \"-i {{out_1}} -vframes 1 {{out_2}}\"\n ],\n \"input_files\": {\n \"in_1\": \"https://storage.rendi.dev/sample/big_buck_bunny_720p_5sec_intro.mp4\",\n \"in_2\": \"https://storage.rendi.dev/sample/big_buck_bunny_720p_5sec_outro.mp4\"\n },\n \"max_command_run_seconds\": 300,\n \"metadata\": {\n \"key\": \"value\"\n },\n \"output_files\": {\n \"out_1\": \"output_concatenated.mp4\",\n \"out_2\": \"thumbnail.jpg\"\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-chained-ffmpeg-commands")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"ffmpeg_commands\": [\n \"-i {{in_1}} -i {{in_2}} -filter_complex \\\"[0:v][1:v]hstack=inputs=2[v]\\\" -map [v] {{out_1}}\",\n \"-i {{out_1}} -vframes 1 {{out_2}}\"\n ],\n \"input_files\": {\n \"in_1\": \"https://storage.rendi.dev/sample/big_buck_bunny_720p_5sec_intro.mp4\",\n \"in_2\": \"https://storage.rendi.dev/sample/big_buck_bunny_720p_5sec_outro.mp4\"\n },\n \"max_command_run_seconds\": 300,\n \"metadata\": {\n \"key\": \"value\"\n },\n \"output_files\": {\n \"out_1\": \"output_concatenated.mp4\",\n \"out_2\": \"thumbnail.jpg\"\n },\n \"vcpu_count\": 8\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rendi.dev/v1/run-chained-ffmpeg-commands")
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_commands\": [\n \"-i {{in_1}} -i {{in_2}} -filter_complex \\\"[0:v][1:v]hstack=inputs=2[v]\\\" -map [v] {{out_1}}\",\n \"-i {{out_1}} -vframes 1 {{out_2}}\"\n ],\n \"input_files\": {\n \"in_1\": \"https://storage.rendi.dev/sample/big_buck_bunny_720p_5sec_intro.mp4\",\n \"in_2\": \"https://storage.rendi.dev/sample/big_buck_bunny_720p_5sec_outro.mp4\"\n },\n \"max_command_run_seconds\": 300,\n \"metadata\": {\n \"key\": \"value\"\n },\n \"output_files\": {\n \"out_1\": \"output_concatenated.mp4\",\n \"out_2\": \"thumbnail.jpg\"\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>"
}
]
}Prefer chained commands over multiple separate
run-ffmpeg-command calls for multi-step pipelines — one round-trip, lower latency, and outputs from earlier commands can feed later ones.Authorizations
Body
application/json
Request model for submitting chained FFmpeg commands.
This model allows submitting multiple FFmpeg commands that run sequentially. Input files can be shared between commands. Output files from earlier commands can be used as inputs to later commands.
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.
Show child attributes
Show child attributes
Example:
{
"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"
}
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
Example:
{
"out_1": "output_one.mp4",
"out_2": "output_two.mp4"
}
FFmpeg command strings using {{alias}} placeholders for input and output files. Each string is a separate ffmpeg command. Can contain up to 10 commands. The output files will be stored in storage for later access.
Input files can be used in all specified commands. Output files from previous commands can be used as input files in later commands. If you wish to use an output file from a previous command as input file in a later command, make sure to use -i right before the output file alias.
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\}\}.
Example:
[
"-i {{in_1}} -i {{in_2}} -filter_complex \"[0:v][1:v]hstack=inputs=2[v]\" -map \"[v]\" {{out_1}}",
"-i {{out_1}} -ss 00:17 -vframes 1 {{out_2}}"
]
Maximum allowed runtime in seconds for a single FFmpeg command, the default is 300 seconds
Example:
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.
Example:
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
Example:
{ "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.
Example:
false
Response
Successfully submitted chained FFmpeg commands
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
Example:
"123e4567-e89b-12d3-a456-426614174000"
Was this page helpful?