Guía de Flova CLI para agentes de IA

Flova CLI te permite usar Flova desde agentes externos como Codex o Claude Code. Solo copia el Prompt de configuración en el Agent que estés usando: instalará y cargará Flova CLI y el Flova Skill, se conectará a tu cuenta de Flova y luego te ayudará en lenguaje natural a crear proyectos, avanzar la generación, leer el estado del proyecto y exportar el video final.

Esto no es lo mismo que usar Flova como una API aislada de generación de imágenes o videos. Flova CLI se conecta al sistema completo de proyectos de Flova: requisitos del proyecto, historial de chat, storyboard, medios, documentos y timeline permanecen dentro del mismo proyecto. El Agent externo conversa contigo, llama al CLI y reporta el progreso; Flova sigue avanzando la creación del video dentro del proyecto.

Cuándo usarlo

Usa Flova CLI cuando ya trabajas en Codex, Claude Code u otro entorno de Agent y quieres que ese Agent participe en la creación de video. Por ejemplo:

• Trabajar en Codex en guiones, referencias o notas de producto mientras le pides a Flova que cree el proyecto de video.
• Pedirle a Claude Code que llame a Flova y genere el storyboard, los medios y el montaje final a partir de tu solicitud en lenguaje natural.
• Hacer que un Agent externo lea el estado real del proyecto de Flova en lugar de describir el progreso de memoria.
• Para tareas largas de generación o exportación, dejar que el Agent siga observando el estado y te devuelva el enlace del proyecto y el resultado final cuando termine.

Cómo se configura

Abre la página de Flova CLI en Flova y entrega Flova al Agent que estás usando:

Copiar el Prompt de configuración

Envía el texto de abajo al AI Agent que estás usando. Instalará y cargará Flova CLI y el Skill, te guiará para iniciar sesión y luego seguirá creando con el Flova Skill.

Ejemplo:

Ayúdame a instalar Flova CLI: https://cli.flova.ai/flovaCLI-setup.md

Describir el video

Describe el video como lo harías en una conversación normal con IA. Incluye el objetivo, duración, relación de aspecto, estilo, contenido clave y expectativa de entrega final. Si quieres elegir primero el Flova Skill adecuado, pídele al Agent que recomiende opciones antes de crear el proyecto.

Ejemplo:

Usa Flova para crear un corto narrativo cálido y fantástico de 30 segundos, en 16:9:En una noche de apagón, un pequeño robot que vive en la azotea de una ciudad descubre una semilla luminosa y supera obstáculos para llevársela a una niña perdida en el piso de abajo.El ritmo debe ser claro: los primeros 5 segundos presentan el apagón y al robot, la parte central muestra cómo entrega la semilla, y el final muestra la ciudad encendiéndose de nuevo.Antes de empezar la producción, recomienda 2-3 Flova Skills adecuados, explica por qué encaja cada uno y espera a que yo elija antes de crear el proyecto.

Elegir y seguir revisando

A medida que el proyecto avanza, puedes revisar el trabajo, dar comentarios y decirle al Agent qué ya está aprobado y qué debe cambiar después.

Ejemplo:

El storyboard está aprobado en general, pero el tercer shot está demasiado oscuro. Ajusta solo el tercer shot, no cambies el diseño de personaje ya confirmado y continúa la producción cuando termine el ajuste.

El Agent sigue el Prompt de configuración para instalar Flova CLI y leer el Flova Skill, que explica cómo crear proyectos, subir materiales, enviar instrucciones creativas, esperar resultados de generación, leer el estado del proyecto y exportar videos.

En la mayoría de los casos, el Agent se conecta a tu cuenta de Flova mediante inicio de sesión en el navegador. Abre una página de autorización; después de iniciar sesión en Flova y aprobar la solicitud, el CLI local puede continuar con los permisos de tu cuenta.

Si el Agent no puede abrir un navegador, o si quieres autorizar directamente a un Agent externo, puedes generar un Agent API Key desde la página de Flova o la configuración de la cuenta y compartirlo por un canal seguro. Un API Key da acceso a tu cuenta de Flova, así que trátalo como una contraseña. Puedes revocarlo cuando ya no lo necesites.

Qué puede hacer el Agent

Después de configurarlo, un Agent externo puede usar Flova CLI para:

• Crear un proyecto nuevo o continuar uno existente.
• Subir imágenes, videos, audio o documentos como materiales del proyecto.
• Enviar instrucciones creativas en lenguaje natural a Flova para avanzar el storyboard, la generación de medios, el audio, la timeline y la preparación de exportación.
• Leer el storyboard, medios, documentos, historial de chat y estado de exportación del proyecto.
• Seguir revisando el estado durante la generación o exportación, y recuperar la observación local si se interrumpió.
• Iniciar la exportación cuando el video esté listo y luego reportar el enlace del proyecto, el video final y el estado actual.

Relación con la app web de Flova

Los proyectos creados o avanzados mediante el CLI siguen siendo proyectos normales de Flova. Puedes volver a la app web de Flova en cualquier momento para revisar el storyboard, Media Space, Docs panel y Timeline, o continuar editando directamente en la web.

Lo mismo aplica al revés: un Agent externo puede continuar trabajando en un proyecto web existente. Lee el estado actual del proyecto y continúa según el storyboard, medios, documentos y preparación de exportación reales.

Consejos de uso

• Dile al Agent el objetivo del video, duración, relación de aspecto, estilo, puntos clave, materiales existentes y expectativa de entrega final.
• Evita decir solo “continúa generando”. Es mejor indicar la etapa actual y el siguiente paso, como refinar primero el storyboard, generar primero keyframes o exportar cuando la timeline esté lista.
• Pídele al Agent que lea el estado del proyecto antes de reportar progreso, para que no adivine a partir de conversaciones anteriores.
• Comparte API Keys solo con Agent en los que confíes. No los pongas en código, logs ni documentos compartidos.
• En tareas largas de generación o exportación, no trates una interrupción local del CLI como un fallo del proyecto. La tarea backend de Flova puede seguir ejecutándose, y el Agent puede recuperar el progreso mediante el CLI.