POST
/
v1
/
run-ffmpeg-command
curl --request POST \
  --url https://api.rendi.dev/v1/run-ffmpeg-command \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "ffmpeg_command": "-i {{in_1}} -ss 00:00 -to 01:00 -vf select='\'''\'''\''lte(n\\,1)+gt(trunc(t/10),trunc(prev_t/10))'\'''\'''\'',setpts='\'''\'''\''PTS*0.025'\'''\'''\'',scale=trunc(oh*a/2)*2:160:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:160:-1:-1 -an -vsync vfr {{out_1}}",
  "input_files": {
    "in_1": "https://storage.rendi.dev/sample/sample.avi"
  },
  "output_files": {
    "out_1": "output1.gif"
  }
}'
{
  "command_id": "123e4567-e89b-12d3-a456-426614174000"
}

Authorizations

​
X-API-KEY
string
header
required

API key required for authentication. Must be provided in the X-API-KEY header.

Body

application/json

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.

​
input_files
object
required

Dictionary mapping file aliases to their publicly accessible paths, file name should appear in the end of the url, keys 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.

Example:
{
  "in_1": "https://storage.rendi.dev/sample/first-video.avi",
  "in_2": "https://storage.rendi.dev/sample/second-video.avi"
}
​
output_files
object
required

Dictionary mapping file aliases to their desired output file names, keys must start with 'out_'

Example:
{
  "out_1": "output_one.avi",
  "out_2": "output_two.avi"
}
​
ffmpeg_command
string
required

FFmpeg command string using {{alias}} placeholders for input and output files

Example:

"-i {{in_1}} -i {{in_2}} -filter_complex [0:v][1:v]hstack=inputs=2[v] -map [v] {{out_1}}"

Response

200
application/json
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.

​
command_id
string
required

Unique identifier for the submitted command

Example:

"123e4567-e89b-12d3-a456-426614174000"