RenderIO Documentation

RenderIO is a media processing API for FFmpeg commands and yt-dlp video downloads. Send a command or a public platform URL over HTTP, and RenderIO runs the work in managed cloud infrastructure. Output files are stored automatically, and you get rich metadata back with every result.

Quick links

• Quickstart - Get your API key and run your first command in 2 minutes
• Authentication - How API keys work
• API Reference - Full endpoint documentation
• Download videos with yt-dlp - Fetch public YouTube, TikTok, Instagram, X/Twitter, Reddit, Vimeo, Twitch, and other platform videos
• Guides - Common FFmpeg recipes (convert, resize, compress, watermark)
• Integrations - Connect RenderIO with n8n, Zapier, Pipedream, and Make

How it works

POST /api/v1/run-ffmpeg-command
     ↓
  RenderIO Worker receives request
     ↓
  FFmpeg runs in a secure Cloudflare Sandbox
     ↓
  Output files stored in R2
     ↓
  Poll for status or receive a webhook

1. Submit - POST your FFmpeg command with input/output file mappings
2. Process - RenderIO downloads your inputs, runs FFmpeg in an isolated container, and uploads the outputs
3. Retrieve - Poll the command status endpoint, or configure a webhook to be notified on completion

Public video downloads

If your source is a public platform URL instead of a direct media file, use the yt-dlp endpoints:

curl -X POST https://renderio.dev/api/v1/ytdlp-download \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: ffsk_your_api_key_here" \
  -d '{
    "input_urls": {
      "in_video": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    }
  }'

Use /api/v1/ytdlp-download for raw downloads and /api/v1/run-ytdlp-command when you want to download then run FFmpeg in one job.

Base URL

https://renderio.dev/api/v1

Endpoint paths in this documentation include the /api/v1/ prefix.

Authentication

Every request requires an API key passed in the X-API-KEY header. Generate your API key from the dashboard to start making requests.

curl https://renderio.dev/api/v1/commands \
  -H "X-API-KEY: ffsk_your_api_key_here"