Search across models, guides, examples and the rest of the docs.
↑↓ Navigateenter Openesc Close
Dashboard
coming-soon
MODEL IDrunware:ffmpeg@0

FFmpeg

FFmpeg is a media processing tool that runs one FFmpeg command over files you pass by URL and returns a single output file. It takes up to 10 video, audio or image inputs and accepts raw input options, output options, filter graphs and stream maps. It fits transcoding, trimming, scaling, overlays, audio extraction and format conversion between generation steps.

FFmpeg

API Options

Platform-level options for task execution and delivery.

taskType

stringrequiredvalue: tools

Identifier for the type of task being performed.

taskUUID

stringrequiredUUID v4

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

webhookURL

stringuri

Webhook URL that receives JSON responses via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

Learn more1 resource

deliveryMethod

stringdefault: sync

Determines how the API delivers task results.

Allowed values2 values
Returns complete results directly in the API response.
Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.
Learn more1 resource

ttl

integermin: 60

Time-to-live (TTL) in seconds for the output files.

includeCost

boolean

Include task cost in the response.

Inputs

Input resources for the task (images, audio, etc). These must be nested inside the inputs object.

inputs » media

media

array of objectsrequiredmin items: 1max items: 101 limit

Ordered list of video, audio or image inputs. The position of each item is the FFmpeg input index that settings.filterComplex and settings.maps reference.

Properties2 properties
inputs » media » options

options

array of strings

Raw FFmpeg input options placed before this input, one token per element. -i is not accepted.

inputs » media » url

url

stringrequired

Publicly accessible URL of the input file. UUIDs are not supported.

Core Parameters

Primary parameters that define the task output.

outputFormat

stringdefault: MP4

File format for the output file. Image formats return a single frame.

Allowed values12 values

model

stringrequiredvalue: runware:ffmpeg@0

Identifier of the tool to run.

Learn more3 resources

Settings

Technical parameters to fine-tune the inference process. These must be nested inside the settings object.

settings » filterComplex

filterComplex

string

Raw FFmpeg -filter_complex graph. Inputs are referenced by their index in inputs.media.

settings » maps

maps

array of strings

Streams written to the output file (-map), as filter labels from settings.filterComplex or input:stream specifiers. FFmpeg selects the streams when omitted.

settings » outputOptions

outputOptions

array of strings

Raw FFmpeg output options, one token per element. -i, -attach and -progress are not accepted. Must produce a single file, so -f followed by hls, segment, dash or image2 is not accepted.

Ask AI
Send feedback