API vidéo faceless, créer des vidéos par code ou avec Claude

Créer une vidéo dans un tableau de bord, c'est simple. En créer trente fait ressortir chaque étape répétitive : ouvrir le formulaire, coller le sujet suivant, choisir les mêmes réglages, valider, puis revenir plus tard chercher le fichier. L'API vidéo faceless existe pour le moment où cette répétition devient le travail lui-même.

Il y a deux façons de l'utiliser. Les développeurs peuvent appeler directement l'API REST. Ceux qui préfèrent une conversation peuvent connecter Claude et demander des vidéos en langage courant. Les deux utilisent les mêmes formats, le même solde de compte et la même bibliothèque de vidéos finies que l'application principale.

Ce qui vient de sortir

• Une API REST sur /api/v1 pour créer des vidéos, suivre leur progression, prévisualiser le coût en crédits, importer des fichiers et gérer les vidéos terminées.
• Un connecteur MCP pour demander le même travail depuis Claude, Claude Code, Cursor ou un autre client compatible.
• La connexion au compte depuis l'appli Claude, sans copier de clé API personnelle dans la conversation.
• Des clés API personnelles pour les intégrations par code, créées et révoquées depuis les Paramètres.

Comment fonctionne l'API

La création de vidéo est asynchrone. Envoyez un topic et un formatId en POST sur /api/v1/videos, et la réponse renvoie immédiatement un identifiant de vidéo et le coût en crédits. Utilisez cet identifiant pour suivre la progression pendant la fabrication. Quand le statut passe à COMPLETED, la réponse contient l'URL du MP4 fini.

1. 1POST /api/v1/videos avec { topic, formatId } : la réponse 202 contient l'identifiant de la vidéo et creditsCost.
2. 2GET /api/v1/videos/{id} environ toutes les minutes : le statut passe par PENDING, PROCESSING puis RENDERING.
3. 3Quand le statut est COMPLETED, videoUrl est votre vidéo finie. Téléchargez-la, publiez-la ou transmettez-la à l'étape suivante de votre processus.

GET /api/v1/formats renvoie les formats disponibles et les paramètres acceptés par chacun. Cela comprend les options de durée, les champs propres à chaque format et les emplacements de casting pour les vidéos de personnages. Vous pouvez garder les modèles recommandés par défaut ou choisir les modèles du script, de la voix, des images, de l'animation et de la musique quand un processus demande plus de contrôle.

Créer des vidéos depuis Claude

Le connecteur MCP, c'est la voie sans code. Ajoutez le connecteur dans Claude, connectez-vous avec votre compte et décrivez la vidéo voulue. Claude peut lister les formats adaptés, prévisualiser le coût en crédits, créer la vidéo, suivre sa progression et renvoyer le lien final dans la conversation.

Le connecteur peut aussi lister les voix, vérifier votre solde, supprimer les vidéos indésirables et importer des références de personnages ou de la musique. Claude Code et Cursor utilisent une clé API personnelle pour les mêmes outils.

Trois recettes d'automatisation

1. La chaîne pilotée par une liste de sujets

Gardez vos idées de sujets validées dans un Google Sheet ou une base Notion. Un scénario n8n ou Zapier planifié peut lire la ligne suivante, créer la vidéo, attendre la fin du rendu et déposer le MP4 dans un dossier de relecture. Gardez une validation humaine avant publication ; l'automatisation sait déplacer le travail, pas décider si une vidéo mérite d'être publiée.

2. Le tuyau de recyclage de contenus

Certains formats acceptent une URL source. Un script peut surveiller votre propre flux RSS, transmettre l'URL d'un nouvel article dans formatInputs et en tirer un brouillon de vidéo. Le même principe fonctionne pour les newsletters et les annonces produit qui vous appartiennent. Relisez le script avant publication, surtout quand la source contient des citations, des dates ou des chiffres qui peuvent demander du contexte.

3. Claude en producteur

Claude est utile quand le processus demande encore du jugement. Planifiez une semaine de sujets dans une seule conversation, comparez les formats et les coûts, puis créez les vidéos une par une. Vous pouvez examiner chaque résultat avant de décider si le sujet suivant mérite le même traitement.

Tarifs et contrôle du compte

L'accès à l'API est inclus dans tous les forfaits payants, sans abonnement API séparé. Les vidéos utilisent la même tarification en crédits que le tableau de bord. Avant d'en créer une, appelez POST /api/v1/videos/preview-credits avec le format et les réglages prévus pour voir le coût exact.

Les clés personnelles peuvent être révoquées depuis les Paramètres, et les connexions Claude peuvent être déconnectées depuis le compte qui les a autorisées. L'historique des crédits affiche les débits de création et les remboursements automatiques des rendus échoués.

Démarrer en 5 minutes

1. 1Ouvrez les Paramètres, allez dans API et créez une clé personnelle. Pour Claude, passez plutôt par le connecteur.
2. 2GET /api/v1/formats pour choisir un format, ou commencez par ai-images-short.
3. 3Envoyez votre premier sujet en POST sur /api/v1/videos et interrogez le statut jusqu'à COMPLETED.
4. 4Consultez la référence des endpoints quand vous avez besoin de paramètres facultatifs, d'imports ou d'un exemple de requête à copier-coller.