API Reference

Voodley API

Integrate AI video creation into your applications with our REST API.

Fast & Reliable

99.9% uptime with global CDN distribution

Secure

OAuth 2.0 authentication with API keys

Rate Limited

Fair usage with generous limits per plan

API Access is Premium Only

API access is available exclusively on the Premium plan. Upgrade now to get your API key.

Authentication

All API requests must include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

You can find your API key in your account settings at app.voodley.com/settings/api

Endpoints

POST/api/v1/videos

Create a new video project

GET/api/v1/videos/:id

Get video project details

POST/api/v1/videos/:id/render

Start video rendering

GET/api/v1/videos/:id/status

Check render status

POST/api/v1/ai/script

Generate script with AI

POST/api/v1/ai/image

Generate image with AI

Code Examples

cURL
curl -X POST https://api.voodley.app/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My First Video",
    "script": "Welcome to Voodley...",
    "style": "whiteboard",
    "voice": "en-US-Neural2-F"
  }'
JavaScript
const response = await fetch('https://api.voodley.app/v1/videos', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'My First Video',
    script: 'Welcome to Voodley...',
    style: 'whiteboard',
    voice: 'en-US-Neural2-F',
  }),
});

const video = await response.json();
console.log(video.id);
Python
import requests

response = requests.post(
    'https://api.voodley.app/v1/videos',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'title': 'My First Video',
        'script': 'Welcome to Voodley...',
        'style': 'whiteboard',
        'voice': 'en-US-Neural2-F',
    }
)

video = response.json()
print(video['id'])

Ready to Integrate?

Upgrade to Premium to get API access and start building.

View PricingContact Sales