Build with the Revid API

1. 1. Get your API key

   Send it in the key header on every call, with a descriptive User-Agent such as my-app/1.0. In code, keep it in an environment variable like REVID_API_KEY.

   Checking your session...
2. 2. Start a render

   Pick a workflow and send its input. You get a pid (project id) back right away; the video renders in the background.

   cURLJavaScriptPython

   Copy

   curl -X POST 'https://www.revid.ai/api/public/v3/render' \
     -H 'Content-Type: application/json' \
     -H 'key: YOUR_API_KEY' \
     -H 'User-Agent: my-app/1.0' \
     -d '{
     "workflow": "script-to-video",
     "source": {
       "text": "Did you know honey never spoils? Archaeologists found 3,000 year old honey in Egyptian tombs, and it was still edible."
     },
     "webhookUrl": "https://your-server.com/revid/webhook"
   }'

3. 3. Get the video

   Your webhookUrl is called when the video is ready. No server to receive webhooks? Poll the status endpoint with the pid every 10 to 20 seconds until status is ready.

   cURLJavaScriptPython

   Copy

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

What each workflow needs (●) and what you can customize (✓). Click a workflow to build a request interactively.