Guida a Flova CLI per agenti IA

Flova CLI ti permette di usare Flova da Agent esterni come Codex e Claude Code. Ti basta copiare il Prompt di configurazione nell’Agent che stai usando: installerà e caricherà Flova CLI e il Flova Skill, si collegherà al tuo account Flova e poi ti aiuterà in linguaggio naturale a creare progetti, avviare la generazione, leggere lo stato del progetto ed esportare il video finale.

Non è la stessa cosa che usare Flova come una singola API di generazione immagini o video. Flova CLI si collega all’intero sistema di progetto Flova: requisiti del progetto, cronologia chat, storyboard, media, documenti e timeline restano nello stesso progetto. L’Agent esterno parla con te, chiama il CLI e riferisce i progressi; Flova continua a portare avanti la creazione del video nel progetto.

Quando usarlo

Usa Flova CLI quando lavori già in Codex, Claude Code o in un altro ambiente Agent e vuoi che quell’Agent partecipi alla creazione video. Per esempio:

• Lavorare in Codex su sceneggiature, riferimenti o note prodotto mentre chiedi a Flova di creare il progetto video.
• Chiedere a Claude Code di chiamare Flova e generare storyboard, media e montaggio finale dalla tua richiesta in linguaggio naturale.
• Fare in modo che un Agent esterno legga lo stato reale del progetto Flova invece di descrivere i progressi a memoria.
• Per generazioni o esportazioni lunghe, lasciare che l’Agent continui a osservare lo stato dell’attività e riferisca il link del progetto e il risultato finale quando termina.

Come configurarlo

Apri la pagina Flova CLI in Flova, poi affida Flova all’Agent che stai usando:

Copia il Prompt di configurazione

Invia il testo qui sotto all’AI Agent che stai usando. Installerà e caricherà Flova CLI e lo Skill, ti guiderà nell’accesso e poi continuerà a creare con il Flova Skill.

Esempio:

Aiutami a installare Flova CLI: https://cli.flova.ai/flovaCLI-setup.md

Descrivi il video

Descrivi il video come faresti in una normale conversazione con un’IA. Includi obiettivo, durata, formato, stile, contenuti principali e aspettative di consegna finale. Se vuoi scegliere prima il Flova Skill più adatto, chiedi all’Agent di suggerire opzioni prima di creare il progetto.

Esempio:

Usa Flova per creare un corto narrativo caldo e fantastico di 30 secondi, in 16:9:Durante una notte di blackout, un piccolo robot che vive sul tetto di una città scopre un seme luminoso e supera ostacoli per portarlo a una bambina smarrita al piano di sotto.Il ritmo deve essere chiaro: i primi 5 secondi presentano il blackout e il robot, la parte centrale mostra il viaggio per consegnare il seme, e il finale mostra la città che si illumina di nuovo.Prima di iniziare la produzione, consiglia 2-3 Flova Skills adatti, spiega perché ciascuno è adatto e aspetta che io scelga prima di creare il progetto.

Scegli e continua la revisione

Man mano che il progetto procede, puoi revisionare il lavoro, dare feedback e dire all’Agent cosa è già stato approvato e cosa deve cambiare.

Esempio:

Lo storyboard è approvato nel complesso, ma il terzo shot è troppo scuro. Regola solo il terzo shot, non modificare il design del personaggio già confermato e continua la produzione dopo aver completato la regolazione.

L’Agent segue il Prompt di configurazione per installare Flova CLI e leggere il Flova Skill, che spiega come creare progetti, caricare materiali, inviare istruzioni creative, attendere i risultati di generazione, leggere lo stato del progetto ed esportare video.

Nella maggior parte dei casi, l’Agent si collega al tuo account Flova tramite accesso nel browser. Apre una pagina di autorizzazione; dopo che accedi a Flova e approvi la richiesta, il CLI locale può continuare con i permessi del tuo account.

Se l’Agent non può aprire un browser, o se vuoi autorizzare direttamente un Agent esterno, puoi generare un Agent API Key dalla pagina Flova o dalle impostazioni account e fornirlo tramite un canale sicuro. Un API Key dà accesso al tuo account Flova, quindi trattalo come una password. Puoi revocarlo quando non ti serve più.

Cosa può fare l’Agent

Dopo la configurazione, un Agent esterno può usare Flova CLI per:

• Creare un nuovo progetto o continuare un progetto esistente.
• Caricare immagini, video, audio o documenti come materiali del progetto.
• Inviare a Flova istruzioni creative in linguaggio naturale per avanzare storyboard, generazione media, audio, timeline e preparazione all’export.
• Leggere storyboard, media, documenti, cronologia chat e stato di export del progetto.
• Continuare a controllare lo stato dell’attività durante generazione o export e recuperare l’osservazione locale se è stata interrotta.
• Avviare l’export quando il video è pronto e poi riferire link del progetto, video finale e stato attuale.

Relazione con l’app web Flova

I progetti creati o avanzati tramite CLI restano normali progetti Flova. Puoi tornare all’app web Flova in qualsiasi momento per rivedere storyboard, Media Space, Docs panel e Timeline, oppure continuare a modificare direttamente nell’app web.

Vale anche il contrario: un Agent esterno può continuare a lavorare su un progetto web esistente. Legge lo stato attuale del progetto e continua in base a storyboard, media, documenti e prontezza di export reali.

Consigli d’uso

• Indica all’Agent obiettivo del video, durata, formato, stile, punti chiave, materiali esistenti e aspettativa di consegna finale.
• Evita di dire solo “continua a generare”. È meglio indicare la fase attuale e il passo successivo, per esempio rifinire prima lo storyboard, generare prima i keyframe o esportare quando la timeline è pronta.
• Chiedi all’Agent di leggere lo stato del progetto prima di riportare i progressi, così non tirerà a indovinare dalla conversazione precedente.
• Condividi API Keys solo con Agent di cui ti fidi. Non inserirle in codice, log o documenti condivisi.
• Per generazioni o export lunghi, non considerare un’interruzione locale del CLI come un fallimento del progetto. Il task backend di Flova potrebbe essere ancora in esecuzione e l’Agent può recuperare i progressi tramite il CLI.