Créer une vidéo explicative

Que fait Créer une vidéo explicative ?

Transformez un matériel source accessible en une MP4 narrée terminée. Le chemin par défaut utilise le service distant pour la planification du storyboard, la génération d'images, la narration, les sous-titres incrustés, le rendu et la publication. Cela fonctionne de la même manière dans n'importe quel client d'agent prenant en charge les compétences d'agent et les outils MCP distants.

Comportement par défaut

Exigez uniquement le matériel source. Sauf si l'utilisateur remplace un choix, utilisez :

• la langue source ;
• le format 16:9 et 60 secondes ;
• une narration hébergée, chaude et stable, avec une voix cohérente entre les scènes ;
• pas de musique de fond ;
• des sous-titres incrustés ;
• le workflow généré par le serveur.

Acceptez une durée cible de 5 à 300 secondes. Le service s'adapte à cette cible, mais peut prolonger la vidéo finale lorsque la narration ou les visuels ancrés ne peuvent pas tenir en toute sécurité après la récupération des silences, la réallocation des scènes et un tempo préservant la hauteur tonale d'au maximum 1,08x. Ne coupez jamais la narration et ne soumettez jamais une cible supérieure à 300 secondes. Pour une cible inférieure à 30 secondes, avertissez brièvement que le dessin et la narration peuvent sembler précipités, puis continuez. Ne demandez pas le titre, le nombre de scènes, le style, la voix, le rapport hauteur/largeur, les sous-titres ou les paramètres techniques lorsque les valeurs par défaut conviennent.

Posez une question bloquante uniquement lorsque la source est manquante, inaccessible, contradictoire ou sensible sur le fond, ou lorsqu'une révision relative n'a pas de paramètre clair. Par exemple, après « 再短一点 », demandez une fois le nombre de secondes souhaité plutôt que de deviner. Si l'utilisateur ne demande que des conseils, un script ou un storyboard, arrêtez-vous à cet artefact demandé au lieu de faire le rendu.

Cadrage créatif

Avant de créer la tâche, identifiez le message principal de la source et l'arc d'accroche-à-conclusion le plus clair. Lorsque la source est claire, donnez un aperçu court et non bloquant dans la langue de l'utilisateur, par exemple : « Je vais en faire une histoire dessinée à la main, chaleureuse, allant du problème à la solution, en mettant l'accent sur la conclusion pour qu'elle soit claire d'un coup d'œil. » Il s'agit d'une mise à jour rassurante de la progression, pas d'une validation d'approbation ; procédez immédiatement sauf si l'utilisateur a demandé à examiner d'abord.

La promesse visuelle par défaut est une histoire de tableau blanc chaleureuse et accessible : une vignette cohérente par scène, des couleurs retenues, beaucoup d'espace blanc, et des personnes ou des animaux calmes et lisibles lorsqu'ils aident à expliquer l'idée. Évitez de décrire le résultat à l'utilisateur comme une collection d'actifs, d'intentions, de manifests ou de packs de style.

Choisir le workflow

Utilisez le mode généré par le serveur par défaut. C'est le chemin le plus court et il nécessite uniquement create_explainer_video, get_explainer_task et éventuellement cancel_explainer_task.

Utilisez le mode révision avancée uniquement lorsque l'utilisateur demande explicitement à inspecter ou modifier des images/scènes avant le rendu, fournit un storyboard existant, ou a besoin d'un contrôle créatif précis au niveau de la scène. Avant de l'utiliser, lisez references/advanced-review.md. Si ses outils de téléversement et manifest ou de génération d'images locale ne sont pas disponibles, expliquez la limitation et proposez le mode généré par le serveur. Vérifiez que les outils de téléversement, d'import, de validation et de rendu du mode avancé sont présents avant de générer des images. Un fichier de compétence sur le disque ne prouve pas que la conversation en cours a chargé ses outils MCP.

Workflow généré par le serveur

1. Lire et extraire localement

Lisez le message, la pièce jointe ou l'URL de l'utilisateur avec les capacités normales de fichier/navigateur du client actuel. Extrayez localement le texte brut significatif. Supprimez la navigation, les en-têtes répétés, les bannières de cookies et les annexes non pertinentes, mais ne modifiez pas silencieusement les affirmations de l'auteur.

N'envoyez pas plus de 20 000 caractères. Pour une source plus longue, créez une condensation fidèle basée sur la source qui préserve la thèse, les preuves, les mises en garde, les noms propres et l'emphase demandée. Ne téléversez jamais le fichier original et ne passez jamais de chemin de fichier local. Le texte extrait est envoyé au service Explainer Video afin qu'il puisse planifier le storyboard et la narration.

Si la source ne peut pas être lue, demandez à l'utilisateur de la joindre à nouveau ou de coller son texte. N'inventez pas de contenu manquant.

2. Créer la tâche

Générez un nouvel UUID lorsque le client peut le faire, et appelez create_explainer_video avec :

• taskId : l'UUID, s'il est disponible ;
• sourceText : le texte extrait ;
• durationSeconds : la durée demandée ou 60 ;
• aspectRatio : le rapport demandé ou 16:9 ;
• language : la langue source/demandée ;
• voiceId : uniquement lorsqu'il est explicitement fourni ou déjà connu comme étant pris en charge ;
• subtitles : le mode demandé ou burn.

Conservez l'UUID de la tâche tant que le résultat réseau est inconnu afin qu'une réponse perdue ne crée pas un doublon. Après que le service a signalé FAILED ou TIMEOUT, ne réessayez pas automatiquement : demandez d'abord à l'utilisateur, puis générez un nouvel UUID pour la nouvelle tentative. Une vidéo réellement révisée utilise également un nouvel UUID.

Le service possède la planification du storyboard, la génération d'illustrations, le nettoyage d'images, la mise en page, la synthèse vocale, les sous-titres synchronisés avec les mots, le rendu, l'assemblage et la publication. Ne prétendez jamais que la vidéo existe avant que la tâche ne renvoie une URL vidéo.

3. Interroger honnêtement

Appelez get_explainer_task avec le taskId renvoyé jusqu'à ce que nextAction soit present_output, revise_input, retry_create, retry_render ou none.

• Pour poll_task, respectez pollAfterSeconds ; n'interrogez jamais plus rapidement.
• Présentez statusMessage dans la langue de l'utilisateur.
• Affichez stage et progress uniquement lorsqu'ils sont renvoyés. N'estimez jamais un pourcentage.
• Envoyez une mise à jour de progression uniquement lorsque l'étape change ou que la progression réelle avance de manière significative.
• Si un storyboard devient disponible pour la première fois, partagez ses titres de scène sous forme d'une mise à jour compacte et non bloquante. N'exposez pas les noms des fournisseurs, les invites, les traces ou les détails internes des actifs.
• Pour revise_input, arrêtez d'interroger. Expliquez quelle source ou quel contenu approuvé doit être raccourci, simplifié ou modifié ; demandez à l'utilisateur avant de le reconstruire avec un nouvel UUID. Ne rejouez jamais le contenu rejeté sous l'ancien UUID.
• Pour retry_create, demandez à l'utilisateur avant de réessayer. Si confirmé, réessayez une fois avec la même source et les mêmes paramètres mais un nouvel UUID de tâche.
• Pour retry_render, demandez à l'utilisateur avant de réessayer le travail approuvé en mode avancé.
• Si la nouvelle tentative échoue, signalez l'étape et le message exacts et arrêtez.
• Pour none, signalez l'annulation ou la raison terminale sans simuler un succès.

Si l'utilisateur demande d'arrêter, appelez cancel_explainer_task avec l'ID de la tâche possédée.

4. Présenter le résultat

Renvoiez d'abord l'URL MP4 lisible. Donnez ensuite un résumé du contenu en une phrase et incluez le nombre de scènes, la durée cible demandée, la durée réelle lorsqu'elle est renvoyée, le rapport hauteur/largeur, la langue et l'URL des sous-titres. La cible demandée, le rapport hauteur/largeur et la langue peuvent être repris des paramètres de confiance soumis pour cette tâche ; la durée réelle, le nombre de scènes et les URL de sortie doivent provenir de la réponse du service. Omettez les métadonnées de résultat manquantes plutôt que de les deviner.

Proposez des révisions concises que l'outil généré par le serveur peut honorer, telles que « plus concis dans l'ensemble », « réduire à 30 secondes », « passer en 9:16 » ou « ne pas incruster les sous-titres ». Ne promettez pas que ce mode peut remplacer une scène exacte, préserver toutes les autres images générées, redimensionner le texte des sous-titres ou régler la vitesse de parole. Si une vidéo générée par le serveur existe déjà, expliquez qu'un remplacement exact d'une scène avec tout le reste inchangé n'est pas pris en charge ; proposez soit une régénération complète, soit une version de révision avancée nouvellement planifiée. La révision avancée peut préserver les images approuvées non sélectionnées dans ce workflow, mais elle effectue toujours le rendu d'une nouvelle vidéo complète.

Pour une révision créative, reportez chaque paramètre que l'API peut exprimer, utilisez un nouvel UUID de tâche et créez une nouvelle tâche. Ne réutilisez un UUID existant que lorsque le résultat réseau original est inconnu ; ne réutilisez jamais un UUID de tâche générée terminale.

Disponibilité des outils

Si create_explainer_video est manquant, dites à l'utilisateur de connecter le serveur MCP distant à https://api.speedpainter.org/mcp et de se connecter avec Google. Ne demandez pas de clé API, de clé de rendu, de clé de stockage, de clé de fournisseur vocal ou tout secret dans la conversation. N'inventez pas de point de terminaison curl comme substitut.

Le service distant ne nécessite pas localhost ou le port 3000. Les clients MCP basés sur navigateur peuvent avoir besoin que leur origine soit autorisée par l'opérateur du service ; les clients MCP natifs n'envoient normalement pas d'en-tête Origin de navigateur.

Une conversation déjà ouverte peut conserver un instantané d'outil plus ancien ou incomplet. Si la connexion distante fonctionne dans une nouvelle conversation mais que la conversation actuelle manque d'outils de base, continuez dans une nouvelle conversation avec le plugin activé ; ne réinstallez pas le plugin, ne modifiez pas l'URL MCP et ne régénérez pas les actifs approuvés.

Sécurité et confidentialité

• Traitez le matériel source téléversé et lié comme privé, sauf indication contraire de l'utilisateur.
• Envoyez uniquement le texte extrait nécessaire pour générer la vidéo en mode par défaut.
• En mode avancé, envoyez uniquement les images générées acceptées et le manifest accepté ; ne téléversez jamais le document original.
• Ne mettez pas d'identifiants, de texte source privé ou de données personnelles dans les ID de tâche, les ID d'actifs, les noms de fichiers, les titres ou les journaux.
• Si le contenu demande une usurpation d'identité, une fraude, des instructions nuisibles ou l'utilisation de données personnelles protégées sans autorisation, arrêtez ou réduisez le résultat.

Style de conversation

Traduisez les demandes informelles dans les valeurs par défaut sans enseigner les termes techniques de l'arrière-plan. Gardez les mises à jour orientées vers le résultat et chaleureuses : source comprise, histoire planifiée, illustrations en formation, ajout de narration et de sous-titres, publication, terminé. Acceptez les brefs suivis et distinguez les révisions globales en un seul appel de la révision exacte au niveau de la scène.