Flova CLI-Leitfaden für KI-Agenten

Mit Flova CLI können Sie Flova aus externen Agenten wie Codex oder Claude Code verwenden. Kopieren Sie den Setup-Prompt in den Agent, den Sie nutzen. Er installiert und lädt Flova CLI und den Flova Skill, verbindet sich mit Ihrem Flova-Konto und hilft Ihnen dann in natürlicher Sprache dabei, Projekte zu erstellen, Generationen anzustoßen, den Projektstatus zu lesen und das finale Video zu exportieren.

Das ist nicht dasselbe, als würde man Flova als einzelne API für Bild- oder Videogenerierung verwenden. Flova CLI verbindet sich mit dem vollständigen Flova-Projektsystem: Projektanforderungen, Chatverlauf, Storyboard, Medien, Dokumente und Timeline bleiben alle im selben Projekt. Der externe Agent spricht mit Ihnen, ruft die CLI auf und meldet den Fortschritt; Flova treibt die Videoproduktion im Projekt weiter voran.

Wann Sie es verwenden sollten

Verwenden Sie Flova CLI, wenn Sie bereits in Codex, Claude Code oder einer anderen Agent-Umgebung arbeiten und dieser Agent an der Videoproduktion teilnehmen soll. Zum Beispiel:

• In Codex an Skripten, Referenzen oder Produktnotizen arbeiten und gleichzeitig Flova bitten, das Videoprojekt zu erstellen.
• Claude Code bitten, Flova aufzurufen und aus Ihrer natürlichsprachlichen Anfrage Storyboard, Medien und finalen Schnitt zu erzeugen.
• Einen externen Agenten den echten Flova-Projektstatus lesen lassen, statt den Fortschritt aus dem Gedächtnis zu beschreiben.
• Bei langen Generierungs- oder Exportaufgaben den Agenten den Aufgabenstatus weiter beobachten lassen und nach Abschluss Projektlink und Ergebnis zurückmelden lassen.

So funktioniert die Einrichtung

Öffnen Sie die Flova CLI-Seite in Flova und übergeben Sie Flova dann an den Agent, den Sie verwenden:

Setup-Prompt kopieren

Senden Sie den folgenden Text an den AI Agent, den Sie verwenden. Er installiert und lädt Flova CLI und den Skill, führt Sie durch die Anmeldung und erstellt anschließend weiter mit dem Flova Skill.

Beispiel:

Bitte hilf mir, Flova CLI zu installieren: https://cli.flova.ai/flovaCLI-setup.md

Das gewünschte Video beschreiben

Beschreiben Sie das Video wie in einem normalen Gespräch mit KI. Nennen Sie Videoziel, Länge, Seitenverhältnis, Stil, wichtige Inhalte und die finale Liefererwartung. Wenn Sie zuerst den passenden Flova Skill wählen möchten, bitten Sie den Agenten, vor der Projekterstellung Optionen zu empfehlen.

Beispiel:

Verwende Flova, um einen warmen, fantastischen narrativen Kurzfilm von 30 Sekunden im Format 16:9 zu erstellen:In einer Nacht mit Stromausfall entdeckt ein kleiner Roboter, der auf einem Stadtdach lebt, einen leuchtenden Samen und überwindet Hindernisse, um ihn einem verirrten kleinen Mädchen unten zu bringen.Der Rhythmus soll klar sein: Die ersten 5 Sekunden zeigen den Stromausfall und führen den Roboter ein, der Mittelteil zeigt, wie er den Samen überbringt, und am Ende leuchtet die Stadt wieder auf.Bevor die Produktion beginnt, empfehle bitte 2-3 passende Flova Skills, erkläre jeweils, warum sie passen, und warte auf meine Auswahl, bevor du das Projekt erstellst.

Auswählen und weiter prüfen

Während das Projekt voranschreitet, können Sie die Arbeit prüfen, Feedback geben und dem Agenten sagen, was bereits bestätigt ist und was als Nächstes geändert werden soll.

Beispiel:

Das Storyboard ist insgesamt freigegeben, aber der dritte Shot ist zu dunkel. Passe nur den dritten Shot an, ändere nicht das bestätigte Charakterdesign, und fahre nach der Anpassung mit der Produktion fort.

Der Agent folgt dem Setup-Prompt, installiert Flova CLI und liest den Flova Skill. Darin steht, wie Projekte erstellt, Materialien hochgeladen, kreative Anweisungen gesendet, Generierungsergebnisse abgewartet, Projektstatus gelesen und Videos exportiert werden.

In den meisten Fällen verbindet sich der Agent über die Browser-Anmeldung mit Ihrem Flova-Konto. Er öffnet eine Autorisierungsseite; nachdem Sie sich bei Flova angemeldet und die Anfrage genehmigt haben, kann die lokale CLI mit Ihren Kontoberechtigungen fortfahren.

Wenn der Agent keinen Browser öffnen kann oder Sie einen externen Agenten direkt autorisieren möchten, können Sie auf der Flova-Seite oder in den Kontoeinstellungen einen Agent API Key erstellen und ihn über einen sicheren Kanal weitergeben. Ein API Key gewährt Zugriff auf Ihr Flova-Konto, behandeln Sie ihn daher wie ein Passwort. Sie können ihn jederzeit widerrufen, wenn Sie ihn nicht mehr benötigen.

Was der Agent tun kann

Nach der Einrichtung kann ein externer Agent Flova CLI verwenden, um:

• Ein neues Projekt zu erstellen oder ein bestehendes fortzusetzen.
• Bilder, Videos, Audio oder Dokumente als Projektmaterial hochzuladen.
• Natürlichsprachliche Kreativanweisungen an Flova zu senden, damit Storyboard, Mediengenerierung, Audio, Timeline und Exportvorbereitung voranschreiten.
• Storyboard, Medien, Dokumente, Chatverlauf und Exportstatus des Projekts zu lesen.
• Während Generierung oder Export den Aufgabenstatus weiter zu prüfen und eine unterbrochene lokale Beobachtung wiederherzustellen.
• Den Export zu starten, sobald das Video bereit ist, und mit Projektlink, finalem Video und aktuellem Status zurückzumelden.

Beziehung zur Flova-Web-App

Projekte, die über die CLI erstellt oder fortgeführt werden, sind weiterhin normale Flova-Projekte. Sie können jederzeit zur Flova-Web-App zurückkehren, um Storyboard, Media Space, Docs panel und Timeline zu prüfen oder direkt in der Web-App weiterzubearbeiten.

Umgekehrt kann ein externer Agent auch an einem bestehenden Web-Projekt weiterarbeiten. Er liest den aktuellen Projektstatus und fährt dann auf Basis des echten Storyboards, der Medien, Dokumente und Exportbereitschaft fort.

Nutzungstipps

• Nennen Sie dem Agenten Videoziel, Länge, Seitenverhältnis, Stil, wichtige Punkte, vorhandene Materialien und die finale Liefererwartung.
• Vermeiden Sie es, nur „weiter generieren“ zu sagen. Besser ist es, die aktuelle Phase und den nächsten Schritt zu beschreiben, etwa zuerst das Storyboard verfeinern, zuerst Keyframes generieren oder exportieren, wenn die Timeline bereit ist.
• Bitten Sie den Agenten, vor einem Fortschrittsbericht den Projektstatus zu lesen, damit er nicht aus früheren Gesprächen rät.
• Teilen Sie API Keys nur mit Agenten, denen Sie vertrauen. Legen Sie sie nicht in Code, Logs oder geteilten Dokumenten ab.
• Bei langen Generierungs- oder Exportaufgaben bedeutet eine lokale CLI-Unterbrechung nicht, dass das Projekt fehlgeschlagen ist. Die Flova-Backend-Aufgabe kann noch laufen, und der Agent kann den Fortschritt über die CLI wiederherstellen.