---
title: "Run up to 10 FFmpeg commands in parallel"
method: POST
path: "/run-multiple-ffmpeg-commands"
tags: ["Commands"]
---

# Run up to 10 FFmpeg commands in parallel

`POST /run-multiple-ffmpeg-commands`

## Request

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

## Request body

- RunMultipleCommandsRequest
  - `commands` RunFfmpegCommandRequest[], required
    - `input_files` InputFiles, required: Input aliases mapped to publicly reachable URLs. Keys must start with `in_`.
    - `output_files` OutputFiles, required: Output aliases mapped to filenames. Keys must start with `out_`.
    - `ffmpeg_command` string, required: FFmpeg arguments referencing aliases as `{{alias}}`. Omit the `ffmpeg` binary name.
    - `metadata` Metadata: Up to 10 arbitrary key/value pairs echoed back on the command.
    - `webhook_url` string, uri: Per-command completion callback. Requires a plan with webhook access.
    - `storage_destination_id` string: Business-plan S3-compatible destination that receives this command's outputs.

## Response `200`

Commands accepted

- RunMultipleCommandsResponse
  - `command_ids` string[], required

## Other responses

- `401`: Missing or invalid API key
- `403`: Plan does not include this capability
- `404`: Resource not found
- `409`: Resource state conflict
- `422`: Request failed validation
- `429`: Rate limit exceeded — retry after the `Retry-After` interval

---

[API](https://skmtc.dev/renderio/apis/renderio-api.md) · [All operations](https://skmtc.dev/renderio/apis/renderio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/renderio/apis/renderio-api/revisions/062c8f1c062b?raw)