Skip to main content
POST
/
ffmpeg
/
execute
Execute an FFmpeg command
curl --request POST \
  --url https://api.rendobar.com/ffmpeg/execute \
  --header 'Content-Type: application/json' \
  --data '
{
  "command": "ffmpeg -i https://example.com/video.mp4 -vf scale=1280:720 -c:v libx264 -crf 23 output.mp4",
  "inputs": {
    "overlay": "https://example.com/logo.png"
  },
  "outputFormat": "mp4",
  "timeout": 450
}
'
{
  "data": {
    "id": "<string>",
    "status": "<string>"
  }
}

Body

application/json
​
command
string
required

FFmpeg command. Can include or omit 'ffmpeg' prefix. Input files can be URLs after -i (auto-extracted) or named placeholders from inputs map. Can include output filename to set format (e.g. 'output.webm'). For standard operations (watermark, transcode, captions), prefer the built-in job types.

Required string length: 1 - 16384
Example:

"ffmpeg -i https://example.com/video.mp4 -vf scale=1280:720 -c:v libx264 -crf 23 output.mp4"

​
inputs
object

Optional named placeholder -> URL map for inputs not in the command string

Example:
{ "overlay": "https://example.com/logo.png" }
​
outputFormat
enum<string>

Override inferred output format

Available options:
mp4,
mkv,
webm,
mov,
avi,
ts,
gif,
png,
jpg,
mp3,
wav,
flac,
ogg,
aac,
opus,
m4a,
srt,
vtt
​
timeout
integer

Maximum execution time in seconds (default: 120)

Required range: 1 <= x <= 900

Response

FFmpeg job created

​
data
object
required