Developer API

Build powerful video applications with our simple and intuitive REST API. Create stunning videos programmatically in minutes.

Quick Start

Get started with the RenderingVideo API in under 5 minutes.

1. Get API Key
Create an API key from your dashboard settings
2. Prepare Config
Define your video using our JSON schema
3. Make Request
Send API request and get your video

1 credit = 1 second of video

Code Examples

Real-world examples to help you get started.

curl -X POST 'https://renderingvideo.com/api/v1/video' \
  -H 'Authorization: Bearer sk-your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "config": {
      "meta": { "version": "2.0.0" },
      "video": { "width": 1920, "height": 1080, "duration": 10 },
      "tracks": [{ "type": "visual", "clips": [{ "type": "text", "text": "Hello World", "start": 0, "duration": 5 }] }]
    }
  }'

API Endpoints

Explore our comprehensive API endpoints.

POST
/api/v1/video
Create a new video render task

Submit your video configuration and start rendering. Consumes credits based on video duration.

GET
/api/v1/video
List all video tasks

Retrieve a paginated list of your video tasks with their current status.

GET
/api/v1/video/:taskId
Get task details

Get detailed information about a specific video task including status and URLs.

POST
/api/v1/video/:taskId/render
Trigger rendering

Start or re-render a video task. Supports custom webhook URLs for notifications.

GET
/api/v1/credits
Get credit balance

Check your current credit balance. 1 credit = 1 second of video.

POST
/api/v1/preview
Create preview link

Create a temporary preview link (7 days validity). Does not consume credits.

Official SDKs

Use our official SDKs for faster integration.

Python SDK
pip install renderingvideo
from renderingvideo import Client

client = Client(api_key="sk-xxx")
task = client.video.create({
    "meta": {"version": "2.0.0"},
    "video": {"width": 1920, "height": 1080, "duration": 10},
    "tracks": [...]
})
print(task.task_id)
Download SDK
Node.js SDK
npm install @renderingvideo/sdk
import { RenderingVideo } from '@renderingvideo/sdk';

const client = new RenderingVideo({ apiKey: 'sk-xxx' });
const task = await client.video.create({
  meta: { version: '2.0.0' },
  video: { width: 1920, height: 1080, duration: 10 },
  tracks: [...]
});
console.log(task.taskId);
Download SDK

Authentication

All API requests require authentication via API Key.

Authentication Methods

Authorization Header (Recommended)

Authorization: Bearer sk-your-api-key

X-API-Key Header

X-API-Key: sk-your-api-key

Query Parameter

?api_key=sk-your-api-key

Security Note: Never expose your API key in client-side code. Always make API calls from your server.

Ready to Build?

Start creating videos programmatically today. Get your API key and start building.