Automatisez les démos produit vidéo avec l’API et le MCP DemoBro

Pour qui et pour quel besoin ?

Développeurs et équipes qui veulent intégrer la préparation et la génération de vidéos à un outil interne, un workflow de livraison ou un agent IA.

Un workflow automatisé doit séparer la préparation, la validation et l’action facturée. Le format DemoDSL décrit le parcours ; l’API HTTP et le MCP donnent accès aux opérations de projet, de rendu et de partage.

Le workflow

1. Créer une clé et découvrir le contrat

   Créez une clé API DemoBro avec les permissions nécessaires et conservez-la dans un gestionnaire de secrets. Le catalogue /api/v1/tools/ et la spécification /api/v1/openapi.json exposent les outils et leurs paramètres actuels.

2. Préparer et valider le scénario

   Partez d’un projet ou d’un modèle. Adaptez le YAML puis appelez validate_demo_config et estimate_demo_cost. Une configuration syntaxiquement valide ne garantit pas que les sélecteurs trouveront les éléments de votre version du produit.

3. Déclencher et suivre un rendu

   Après accord sur le devis, lancez create_render sur le projet ou render_demo_from_yaml. Conservez le render_id retourné et suivez-le avec get_render, wait_for_render ou le flux SSE documenté.

4. Contrôler puis partager

   Vérifiez l’état terminal et le résultat métier, même après un HTTP 200. Regardez la vidéo terminée avant de créer son lien de partage. Un délai d’attente du client n’annule pas le rendu : reprenez le suivi du même identifiant.

Une archive des paramètres API

L’archive « API & Plugins » est une capture silencieuse de paramètres d’intégration ; elle ne montre pas l’exécution d’un appel HTTP. Utilisez le catalogue actuel et la documentation pour vérifier les opérations et paramètres, plutôt que les libellés de cette ancienne vidéo.

Prérequis

• Un compte, une clé API valide et les permissions de lecture, d’écriture ou de rendu correspondant aux opérations choisies.
• Des crédits et quotas disponibles ; les appels MCP et HTTP partagent les limites du compte et de la clé.
• Un environnement cible accessible au mode de capture retenu et une validation humaine pour les données sensibles ou les actions à effet réel.

Limites à connaître

• Un appel de rendu peut être facturé. Ne relancez pas une création de rendu parce qu’un client a cessé d’attendre ; interrogez d’abord son identifiant existant.
• Les erreurs métier peuvent être retournées dans le corps d’une réponse HTTP 200. Contrôlez error, isError, quota_exceeded ou concurrency_limited.
• L’API distante interprète les chemins locaux sur le serveur. Pour un fichier sur votre poste, utilisez un mécanisme d’import adapté au lieu d’envoyer un chemin local.
• Un agent MCP doit être compatible avec le transport et l’authentification retenus. L’accès API ne remplace pas les autorisations sur votre application ou sur un CRM.

Préparer votre première démo

DemoBro est le service de génération vidéo sur demobro.com. Les scénarios s’appuient sur DemoDSL, le format qui décrit les actions et la présentation de la démo.