Revid API Documentation | Create Videos Programmatically

Create videos programmatically

One endpoint, ten workflows. Pick what you start from - a script, a prompt, a link, or a file - and the API handles visuals, voice-over, captions, and music. Every render call costs 10 credits plus generation costs, and you can estimate any payload for free before running it.

What are you starting from?

The workflow field decides everything else - required input, defaults, and which parameters apply.

A script - the exact words to be spoken

An idea or topic - the AI writes the script

A link - article, music, or any web page

A file - audio or video to transform

Your first video in 3 steps

1 - Get a key
Grab your API key from your account settings. Send it in the key header on every call.

2 - Start a render

curl -X POST 'https://www.revid.ai/api/public/v3/render' \
  -H 'Content-Type: application/json' \
  -H 'key: YOUR_API_KEY' \
  -d '{
    "workflow": "script-to-video",
    "source": { "text": "Did you know honey never spoils?" },
    "webhookUrl": "https://your-server.com/revid/webhook"
  }'

3 - Get the result
The render is asynchronous: your webhookUrl is called when the video is ready, or poll the status endpoint with the pid you received.

curl 'https://www.revid.ai/api/public/v3/status?pid=YOUR_PID' \
  -H 'key: YOUR_API_KEY'

All workflows at a glance

Workflow Requires source media voice captions music avatar options render
Script to video source.text ● ✓ ✓ ✓ ✓ ✓ ✓ ✓
Prompt to video source.prompt ● ✓ ✓ ✓ ✓ — ✓ ✓
Audio to video source.url ● ✓ — ✓ ✓ — ✓ ✓
Music to video source.url ● ✓ — ✓ ✓ — ✓ ✓
Article to video source.url ● ✓ ✓ ✓ ✓ — ✓ ✓
Avatar to video source.text + avatar.url ● ✓ ✓ ✓ ✓ ● ✓ ✓
Static background video source.text or source.url ● ✓ ✓ ✓ ✓ — ✓ ✓
Motion transfer source.url + media.provided[] with 1 image (the target character) ● ● ✓ ✓ ✓ — ✓ ✓
Caption video source.url ● ✓ — ✓ ✓ — ✓ ✓
Ad generator source.prompt or media.provided[] ● ✓ ✓ ✓ ✓ — ✓ ✓

● required
✓ available
— not used