Video Renderer API

Introduction

Provider-agnostic video rendering API

Video Renderer API

A provider-agnostic video rendering system that transforms compositions from various external formats into videos using FFmpeg.

Features

  • Multi-provider support: Accept compositions from Rendley or direct unified format
  • Server-side rendering: Powered by FFmpeg for high-quality video output
  • Async processing: Jobs are processed via Trigger.dev for reliable background execution
  • Webhook support: Get notified when your render completes

Quick Start

Submit a render job:

curl -X POST http://localhost:3000/api/render \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "rendley",
    "composition": { ... },
    "assetUrls": { "media-1": "https://example.com/video.mp4" }
  }'

Response:

{
  "jobId": "abc123",
  "status": "queued",
  "createdAt": "2024-01-01T00:00:00.000Z"
}

Check job status:

curl http://localhost:3000/api/render/abc123

Supported Providers

ProviderDescription
rendleyRendley SDK composition format
unifiedDirect unified composition format

Next Steps

On this page