Documentation API

Intégrez CinematicAds dans votre stack

API REST complète pour automatiser la génération de vidéos publicitaires. Authentification simple, endpoints puissants.

Authentification

Toutes les requêtes API nécessitent un token Bearer dans le header Authorization.

Header

Authorization: Bearer YOUR_API_KEY

Obtenez votre clé API dans les paramètres de votre compte.

Endpoints

POST/api/workflow

Exécuter un workflow

Lance un workflow de génération vidéo (avatar, influencer, clone, factory, cinematic).

typestringrequiredType de workflow: avatar | influencer | clone | factory | cinematic

scriptstringScript pour avatar/influencer workflows

urlstringURL pour clone/factory workflows

conceptstringConcept pour cinematic workflow

GET/api/health

Health Check

Vérifie l'état des services CinematicAds.

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

Recevez des notifications en temps réel sur l'état de vos workflows.

workflow.startedUn workflow a démarré

workflow.completedUn workflow est terminé avec succès

workflow.failedUn workflow a échoué

video.readyUne vidéo est prête au téléchargement

SDKs Officiels

Bibliothèques clientes pour intégrer CinematicAds rapidement.

Node.jsRoadmap T1 2025

npm install @cinematicads/sdk

PythonRoadmap T2 2025

pip install cinematicads

PHPRoadmap T2 2025

composer require cinematicads/sdk

Prêt à intégrer?

Obtenir ma clé API