Guia da Flova CLI para agentes de IA

O Flova CLI permite usar o Flova a partir de Agent externos, como Codex e Claude Code. Basta copiar o Prompt de configuração para o Agent que você está usando: ele instala e carrega o Flova CLI e o Flova Skill, conecta-se à sua conta Flova e então ajuda, em linguagem natural, a criar projetos, avançar a geração, ler o estado do projeto e exportar o vídeo final.

Isso não é o mesmo que usar o Flova como uma API isolada de geração de imagem ou vídeo. O Flova CLI se conecta ao sistema completo de projetos do Flova: requisitos do projeto, histórico de chat, storyboard, mídia, documentos e timeline permanecem dentro do mesmo projeto. O Agent externo conversa com você, chama o CLI e informa o progresso; o Flova continua avançando a criação do vídeo dentro do projeto.

Quando usar

Use o Flova CLI quando você já trabalha no Codex, Claude Code ou outro ambiente de Agent e quer que esse Agent participe da criação de vídeo. Por exemplo:

• Trabalhar no Codex em roteiros, referências ou notas de produto enquanto pede ao Flova para criar o projeto de vídeo.
• Pedir ao Claude Code para chamar o Flova e gerar o storyboard, as mídias e a edição final a partir da sua solicitação em linguagem natural.
• Fazer um Agent externo ler o estado real do projeto Flova, em vez de descrever o progresso de memória.
• Em tarefas longas de geração ou exportação, deixar o Agent acompanhar o status da tarefa e retornar com o link do projeto e o resultado final quando terminar.

Como configurar

Abra a página Flova CLI no Flova e entregue o Flova ao Agent que você está usando:

Copiar o Prompt de configuração

Envie o texto abaixo ao AI Agent que você está usando. Ele instala e carrega o Flova CLI e o Skill, guia você pelo login e depois continua criando com o Flova Skill.

Exemplo:

Ajude-me a instalar o Flova CLI: https://cli.flova.ai/flovaCLI-setup.md

Descrever o vídeo

Descreva o vídeo como faria em uma conversa normal com IA. Inclua objetivo, duração, proporção, estilo, conteúdo principal e expectativa de entrega final. Se quiser escolher primeiro o Flova Skill certo, peça ao Agent para recomendar opções antes de criar o projeto.

Exemplo:

Use o Flova para criar um curta narrativo caloroso e fantástico de 30 segundos, em 16:9:Em uma noite de apagão, um pequeno robô que vive no terraço de uma cidade descobre uma semente brilhante e supera obstáculos para entregá-la a uma menininha perdida no andar de baixo.O ritmo deve ser claro: os primeiros 5 segundos apresentam o apagão e o robô, o meio mostra o percurso para entregar a semente, e o final mostra a cidade se iluminando novamente.Antes de começar a produção, recomende 2-3 Flova Skills adequados, explique por que cada um combina e espere eu escolher antes de criar o projeto.

Escolher e continuar revisando

À medida que o projeto avança, você pode revisar o trabalho, dar feedback e dizer ao Agent o que já foi aprovado e o que deve mudar em seguida.

Exemplo:

O storyboard está aprovado no geral, mas o terceiro shot está escuro demais. Ajuste apenas o terceiro shot, não altere o design de personagem já confirmado e continue a produção depois que o ajuste terminar.

O Agent segue o Prompt de configuração para instalar o Flova CLI e ler o Flova Skill, que explica como criar projetos, enviar materiais, mandar instruções criativas, aguardar resultados de geração, ler o estado do projeto e exportar vídeos.

Na maioria dos casos, o Agent se conecta à sua conta Flova pelo login no navegador. Ele abre uma página de autorização; depois que você entra no Flova e aprova a solicitação, o CLI local pode continuar com as permissões da sua conta.

Se o Agent não conseguir abrir um navegador, ou se você quiser autorizar diretamente um Agent externo, gere um Agent API Key na página do Flova ou nas configurações da conta e compartilhe por um canal seguro. Um API Key dá acesso à sua conta Flova, então trate-o como uma senha. Você pode revogá-lo sempre que não precisar mais dele.

O que o Agent pode fazer

Depois da configuração, um Agent externo pode usar o Flova CLI para:

• Criar um novo projeto ou continuar um projeto existente.
• Enviar imagens, vídeos, áudio ou documentos como materiais do projeto.
• Enviar instruções criativas em linguagem natural ao Flova para avançar storyboard, geração de mídia, áudio, timeline e preparação de exportação.
• Ler storyboard, mídias, documentos, histórico de chat e status de exportação do projeto.
• Continuar verificando o status da tarefa durante geração ou exportação, e recuperar a observação local se ela for interrompida.
• Iniciar a exportação quando o vídeo estiver pronto e retornar com o link do projeto, o vídeo final e o status atual.

Relação com o app web do Flova

Projetos criados ou avançados pelo CLI continuam sendo projetos Flova comuns. Você pode voltar ao app web do Flova a qualquer momento para revisar storyboard, Media Space, Docs panel e Timeline, ou continuar editando diretamente no app web.

O inverso também vale: um Agent externo pode continuar trabalhando em um projeto web existente. Ele lê o estado atual do projeto e continua com base no storyboard, mídias, documentos e prontidão de exportação reais.

Dicas de uso

• Informe ao Agent o objetivo do vídeo, duração, proporção, estilo, pontos principais, materiais existentes e expectativa de entrega final.
• Evite dizer apenas “continue gerando”. É melhor indicar a etapa atual e o próximo passo, como refinar primeiro o storyboard, gerar keyframes primeiro ou exportar quando a timeline estiver pronta.
• Peça ao Agent para ler o estado do projeto antes de reportar progresso, para não adivinhar com base em conversas anteriores.
• Compartilhe API Keys apenas com Agent confiáveis. Não coloque em código, logs ou documentos compartilhados.
• Em tarefas longas de geração ou exportação, não trate uma interrupção local do CLI como falha do projeto. A tarefa backend do Flova pode continuar em execução, e o Agent pode recuperar o progresso pelo CLI.