Guide de Flova CLI pour les agents IA

Flova CLI vous permet d’utiliser Flova depuis des Agent externes comme Codex ou Claude Code. Il suffit de copier le Prompt de configuration dans l’Agent que vous utilisez : il installe et charge Flova CLI ainsi que le Flova Skill, se connecte à votre compte Flova, puis vous aide en langage naturel à créer des projets, lancer la génération, lire l’état réel du projet et exporter la vidéo finale.

Ce n’est pas la même chose qu’utiliser Flova comme une simple API de génération d’image ou de vidéo. Flova CLI se connecte au système complet de projet Flova : exigences du projet, historique de conversation, storyboard, médias, documents et timeline restent dans le même projet. L’Agent externe dialogue avec vous, appelle le CLI et rapporte la progression ; Flova continue à faire avancer la création vidéo dans le projet.

Quand l’utiliser

Utilisez Flova CLI si vous travaillez déjà dans Codex, Claude Code ou un autre environnement d’Agent et que vous voulez que cet Agent participe à la création vidéo. Par exemple :

• Travailler dans Codex sur des scripts, références ou notes produit tout en demandant à Flova de créer le projet vidéo.
• Demander à Claude Code d’appeler Flova pour générer le storyboard, les médias et le montage final à partir de votre demande en langage naturel.
• Permettre à un Agent externe de lire l’état réel du projet Flova au lieu de décrire la progression de mémoire.
• Pour les générations ou exports longs, laisser l’Agent suivre l’état de la tâche et revenir avec le lien du projet et le résultat final une fois terminé.

Fonctionnement de la connexion

Ouvrez la page Flova CLI dans Flova, puis confiez Flova à l’Agent que vous utilisez :

Copier le Prompt de configuration

Envoyez le texte ci-dessous à l’AI Agent que vous utilisez. Il installe et charge Flova CLI et le Skill, vous guide dans la connexion, puis continue la création avec le Flova Skill.

Exemple :

Aide-moi à installer Flova CLI : https://cli.flova.ai/flovaCLI-setup.md

Décrire la vidéo

Décrivez la vidéo comme dans une conversation normale avec une IA. Indiquez l’objectif, la durée, le format, le style, les éléments clés et l’attente de livraison finale. Si vous voulez choisir d’abord le bon Flova Skill, demandez à l’Agent de recommander des options avant de créer le projet.

Exemple :

Utilise Flova pour créer un court métrage narratif chaleureux et fantastique de 30 secondes, en 16:9 :Pendant une panne de courant, un petit robot vivant sur le toit d’un immeuble découvre une graine lumineuse et surmonte des obstacles pour l’apporter à une petite fille perdue en bas.Le rythme doit être clair : les 5 premières secondes présentent la panne et le robot, le milieu montre son trajet pour livrer la graine, et la fin rallume la ville.Avant de commencer la production, recommande 2 à 3 Flova Skills adaptés, explique pourquoi chacun convient, puis attends mon choix avant de créer le projet.

Choisir et continuer à relire

Au fur et à mesure que le projet avance, vous pouvez relire le travail, donner des retours et dire à l’Agent ce qui est déjà validé et ce qui doit changer.

Exemple :

Le storyboard est globalement validé, mais le troisième shot est trop sombre. Ajuste uniquement le troisième shot, ne change pas le design de personnage déjà confirmé, puis continue la production une fois l’ajustement terminé.

L’Agent suit le Prompt de configuration pour installer Flova CLI et lire le Flova Skill, qui explique comment créer des projets, téléverser des éléments, envoyer des instructions créatives, attendre les résultats de génération, lire l’état du projet et exporter les vidéos.

Dans la plupart des cas, l’Agent se connecte à votre compte Flova via un flux de connexion dans le navigateur. Il ouvre une page d’autorisation ; après votre connexion à Flova et votre approbation, le CLI local peut continuer avec les permissions de votre compte.

Si l’Agent ne peut pas ouvrir de navigateur, ou si vous voulez autoriser directement un Agent externe, vous pouvez générer un Agent API Key depuis la page Flova ou les paramètres du compte et le transmettre par un canal sécurisé. Un API Key donne accès à votre compte Flova : traitez-le comme un mot de passe. Vous pouvez le révoquer dès que vous n’en avez plus besoin.

Ce que l’Agent peut faire

Après configuration, un Agent externe peut utiliser Flova CLI pour :

• Créer un nouveau projet ou continuer un projet existant.
• Téléverser des images, vidéos, fichiers audio ou documents comme matériaux de projet.
• Envoyer à Flova des instructions créatives en langage naturel pour faire avancer le storyboard, la génération de médias, l’audio, la timeline et la préparation de l’export.
• Lire le storyboard, les médias, les documents, l’historique de conversation et l’état d’export du projet.
• Vérifier l’état des tâches pendant la génération ou l’export, et récupérer l’observation locale si elle a été interrompue.
• Lancer l’export quand la vidéo est prête, puis revenir avec le lien du projet, la vidéo finale et l’état actuel.

Relation avec l’application web Flova

Les projets créés ou avancés via le CLI restent des projets Flova ordinaires. Vous pouvez revenir à tout moment dans l’application web Flova pour consulter le storyboard, Media Space, le Docs panel et la Timeline, ou continuer à modifier directement dans l’application web.

L’inverse est également vrai : un Agent externe peut continuer à travailler sur un projet web existant. Il lit l’état actuel du projet, puis poursuit à partir du storyboard, des médias, des documents et de l’état de préparation à l’export réels.

Conseils d’utilisation

• Donnez à l’Agent l’objectif de la vidéo, la durée, le format, le style, les points clés, les matériaux existants et l’attente de livraison finale.
• Évitez de dire seulement « continue à générer ». Il vaut mieux préciser l’étape actuelle et la prochaine action, par exemple affiner d’abord le storyboard, générer d’abord les keyframes, ou exporter lorsque la timeline est prête.
• Demandez à l’Agent de lire l’état du projet avant de rapporter la progression, afin qu’il ne devine pas à partir d’une conversation précédente.
• Ne partagez les API Keys qu’avec des Agent de confiance. Ne les placez pas dans du code, des journaux ou des documents partagés.
• Pour les générations ou exports longs, ne considérez pas une interruption locale du CLI comme un échec du projet. La tâche backend Flova peut encore être en cours, et l’Agent peut récupérer la progression via le CLI.