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