API for programmatic video

Build video generation into your product.

Create preview links, render final videos, upload files, and track credits with API-key authenticated endpoints.

Get API key Read docs

Create an API key

Generate a scoped key from settings and send it as a Bearer token.

Send a schema

Use the RenderingVideo JSON shape with meta, assets, tracks, and clips.

Preview or render

Start with temporary previews, then convert to permanent render jobs when ready.

Code examples

The same API works from cURL, Node.js, Python, and any HTTP client.

curl -X POST https://your-domain.com/api/v1/video \
  -H "Authorization: Bearer rv_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"config":{"meta":{"version":"2.0.0","width":1280,"height":720,"fps":30},"tracks":[{"clips":[{"type":"text","start":0,"duration":3,"text":"Hello RenderingVideo"}]}]}}'

Core endpoints

Thin product APIs backed by the migrated RenderingVideo render service.

POST/api/v1/preview

Create temporary preview

Returns a playback URL for fast schema validation and review.

POST/api/v1/video

Create video task

Stores a permanent task and returns preview/config URLs.

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

Trigger render

Consumes credits, starts the remote render pipeline, and tracks status.

GET/api/v1/files

List uploaded files

Use uploaded assets in schemas and keep media organized by user.

Authentication

Public API endpoints require an API key in the Authorization header. Dashboard pages continue to use the signed-in session.