API Documentation

Integrate CinematicAds into your stack

Complete REST API to automate video ad generation. Simple authentication, powerful endpoints.

Authentication

All API requests require a Bearer token in the Authorization header.

Header

Authorization: Bearer YOUR_API_KEY

Get your API key from your account settings.

Endpoints

POST/api/workflow

Execute a workflow

Launches a video generation workflow (avatar, influencer, clone, factory, cinematic).

typestringrequiredWorkflow type: avatar | influencer | clone | factory | cinematic

scriptstringScript for avatar/influencer workflows

urlstringURL for clone/factory workflows

conceptstringConcept for cinematic workflow

GET/api/health

Health Check

Checks the status of CinematicAds services.

cURL Example

curl -X POST https://cinematicads.studio/api/workflow \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "avatar", "script": "Hello, welcome to our product demo!"}'

Response

{
  "success": true,
  "workflowId": "wf_abc123xyz",
  "status": "processing",
  "estimatedTime": 120
}

Webhooks

Receive real-time notifications about your workflow status.

workflow.startedA workflow has started

workflow.completedA workflow completed successfully

workflow.failedA workflow failed

video.readyA video is ready for download

Official SDKs

Client libraries to integrate CinematicAds quickly.

Node.jsRoadmap Q1 2025

npm install @cinematicads/sdk

PythonRoadmap Q2 2025

pip install cinematicads

PHPRoadmap Q2 2025

composer require cinematicads/sdk

Ready to integrate?

Get my API key