Commands

Run a single FFmpeg command

Accepts the command and returns immediately with a command_id. Reference inputs and outputs from ffmpeg_command using {{alias}} placeholders.

post/run-ffmpeg-command

Request

  • Base URL: https://renderio.dev/api/v1
  • URL: https://renderio.dev/api/v1/run-ffmpeg-command
  • Auth: API key in header X-API-KEY

Request body

input_filesInputFiles required

Input aliases mapped to publicly reachable URLs. Keys must start with in_.

output_filesOutputFiles required

Output aliases mapped to filenames. Keys must start with out_.

ffmpeg_commandstring required

FFmpeg arguments referencing aliases as {{alias}}. Omit the ffmpeg binary name.

metadataMetadata

Up to 10 arbitrary key/value pairs echoed back on the command.

webhook_urlstring uri

Per-command completion callback. Requires a plan with webhook access.

storage_destination_idstring

Business-plan S3-compatible destination that receives this command's outputs.

Example request

{
  "input_files": {
    "in_video": "https://example.com/input.mp4"
  },
  "output_files": {
    "out_video": "output.mp4"
  },
  "ffmpeg_command": "-i {{in_video}} -c:v libx264 {{out_video}}"
}

Response

Command accepted

command_idstring uuid required

Changes

No recorded changes to this operation across all 1 revision of this API.