Automatiser la création de vidéos avec l'API

Une API REST sous /api/v1, authentifiée avec une clé API que vous créez dans votre compte. Elle couvre les mêmes fonctionnalités que le reste du produit :

• Vidéos — créez un rendu à partir d'une URL et d'un brief, consultez son statut, récupérez le MP4 finalisé.
• Sites — analysez un domaine, obtenez un plan des pages méritant une vidéo, générez-les.
• Personnages et captures — les éléments réutilisables partagés par une série.
• Émissions — épisodes récurrents alimentés par un flux.
• Connexions — enregistrez une source MCP ou HTTP à partir de laquelle un format peut extraire des données.

C'est une fonctionnalité Pro, incluse à partir de 49 $ par mois. La clé est liée à votre compte et à votre solde de crédits ; il n'y a pas de tarification API distincte.

Le rendu est asynchrone, et toute intégration doit être conçue en conséquence.

1. 1Créer. Envoyez l'URL, le brief, le rapport d'aspect et toute limite budgétaire. Vous recevez immédiatement un identifiant — le rendu n'a pas encore commencé, et encore moins terminé.
2. 2Interroger. Demandez le statut. Vous obtenez la phase, la progression et une estimation recalculée en fonction du temps réel d'exécution de ce rendu spécifique, plutôt qu'une moyenne.
3. 3Lire le résultat. Une fois terminé, vous obtenez le MP4 — et les avertissements.
4. 4Vérifier les avertissements. Un rendu peut être terminé sans être complet, et le statut indique done dans les deux cas. Un pipeline automatisé qui ignore les avertissements est un pipeline qui publie des films incomplets.

Prévoyez plusieurs minutes par rendu, davantage s'il génère des clips. Ne maintenez pas une requête HTTP ouverte en attendant la fin.

• Vidéo de catalogue. Une vidéo par page produit, générée à la publication, intégrée sur la page. C'est l'automatisation la plus rentable, car elle s'applique à des pages qui génèrent déjà du trafic.
• Notes de version en vidéo. Un film par version, généré à partir de l'entrée du journal des modifications. create_animation ne nécessite aucune page, le texte du journal des modifications est donc suffisant.
• Actualisation des vidéos obsolètes. Refaites le rendu lorsque la page change. Une vidéo de démonstration qui correspond au produit actuel a plus de valeur qu'une vidéo mieux produite montrant l'interface du trimestre précédent.
• Variantes par langue. La même page, filmée avec une narration dans chaque langue dans laquelle vous vendez.

Classez avant de générer. L'instinct avec une API est de l'exécuter sur tout ; le résultat est une facture de crédits élevée et des vidéos sur des pages que personne ne visite. Triez par trafic, prenez la tranche supérieure, mesurez, puis étendez.

1. 1Générer des visuels d'IA par défaut. Un pipeline avec des clips activés sur l'ensemble d'un catalogue est le moyen le plus rapide de vider un solde — un clip maison coûte 311 crédits contre 40 pour un rendu, et un modèle nommé peut coûter bien plus. Définissez ai_budget sur chaque appel, et mettez-le à zéro par défaut pour les tâches en masse.
2. 2Refaire le rendu de pages inchangées selon un calendrier. Déclenchez le rendu lors d'un changement, et non via une tâche cron. Une tâche nocturne sur un catalogue statique paie le prix fort chaque nuit pour un résultat identique.
3. 3Ignorer les avertissements. Ils sont la seule chose qui sépare un pipeline automatisé de la publication d'un film dont la scène clé est silencieusement revenue à une carte de texte.

Les rendus s'exécutent un par un par compte plutôt que tous en même temps ; soumettre deux cents tâches les met en file d'attente plutôt que de lancer deux cents navigateurs. Concevez pour une file d'attente : soumettez, enregistrez l'identifiant, interrogez avec un délai exponentiel (backoff).

Un rendu qui échoue pour une raison système est automatiquement remboursé, donc une nouvelle tentative après un échec réel ne coûte pas deux fois. Un rendu qui échoue parce que la page n'a pas pu être atteinte — vérification de robot, mur d'authentification, URL morte — est refusé avant toute facturation, et il continuera d'être refusé jusqu'à ce que la page change. Réessayer en boucle n'aboutit à rien ; vérifiez la raison et ignorez-le.

Pour les pages derrière une connexion, enregistrez d'abord une session de capture depuis l'extension VS Code ou navigateur. Elle est limitée à cette origine, expire dans les trois jours et est une fonctionnalité du plan Scale.