OmniFlow Studio

Habilidad para Agentes de OmniFlow Studio

Esta habilidad otorga a agentes de IA codificadores y orquestadores control directo sobre OmniFlow Studio — un puente autónomo que conecta agentes locales de IA con lienzos de medios generativos de alta fidelidad en Google Chrome.

Cuándo Usar Esta Habilidad

Usa esta habilidad siempre que:

1. El usuario solicite generar videos de IA cinematográficos, material de archivo B, arte conceptual o guiones gráficos.
2. Estés construyendo o dirigiendo un cortometraje o anuncio creativo autónomo de múltiples tomas.
3. Generes hojas de referencia de personajes (consistencia de rotación) en múltiples escenas de video.
4. Automatices colas de generación por lotes de imágenes/videos sin pagar tarifas de API por minuto.
5. Se pregunte sobre el estado actual del puente OmniFlow, cuotas de generación o progreso de cola activa.

---

🚀 Protocolo de Ejecución Rápida para Agentes

Antes de enviar trabajos de medios, cada agente debe seguir este bucle de verificación de 3 pasos:

Paso 1: Verificación de Salud y Puente

Verifica que el demonio del puente local OmniFlow esté ejecutándose en http://127.0.0.1:8792:

node scripts/check-bridge.js
# O directamente con curl:
curl -s http://127.0.0.1:8792/status

• Si está fuera de línea: Indica al usuario o ejecuta: omniflow bridge start (o inicia la tarea en segundo plano del puente).
• Si está en línea: Verifica que extensionConnected sea true y tabVisible sea true (significa que Chrome tiene Google Flow abierto).

Paso 2: Enviar un Trabajo de Generación

Los agentes pueden enviar trabajos a través de la API REST o los scripts auxiliares proporcionados:

# Script auxiliar (más fácil):
node scripts/submit-shot.js --mode flow-text-to-video --prompt "Vuelo de dron cinematográfico en Tokio cyberpunk neón lluvia 8k" --aspectRatio 16:9 --duration 6s

# O HTTP POST directo:
curl -s -X POST http://127.0.0.1:8792/jobs \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "flow-text-to-video",
    "prompt": "Vuelo de dron cinematográfico en Tokio cyberpunk neón lluvia 8k",
    "params": {
      "aspectRatio": "16:9",
      "duration": "6s",
      "videoModel": "veo-3.1-fast",
      "downloadSubfolder": "MiProyecto"
    }
  }'

Paso 3: Monitorear y Recuperar Medios Descargados

Consulta periódicamente hasta que el estado del trabajo cambie a completed:

node scripts/list-jobs.js
# O:
curl -s http://127.0.0.1:8792/jobs

Cuando status === "completed", recupera la ruta del archivo local del array files (ej. Downloads/MiProyecto/...mp4).

---

🛠️ Modos de Generación Soportados

ID de Modo	Descripción	Parámetros Clave
flow-text-to-video	Genera video en movimiento a partir de una descripción de texto	prompt, aspectRatio (16:9, 9:16, 1:1), duration (4s, 6s, 8s)
flow-text-to-image	Genera imágenes fijas fotorrealistas o estilizadas	prompt, aspectRatio, imageModel (nano-banana-pro)
flow-frame-to-video	Extiende una imagen fija o fotograma clave en video continuo	prompt, duration, token de activo de referencia
flow-create-character	Genera hoja de rotación de 4 ángulos para consistencia facial	characterName, visualDescription, voicePreset

---

🎛️ Invocaciones de Herramientas MCP (Si el Servidor MCP está Activo)

Si el servidor MCP de OmniFlow está conectado en tu entorno de agente, llama directamente a estas herramientas nativas:

• omniflow_status: Verifica el estado del puente y la conexión del navegador.
• omniflow_generate_shot: Encola una sola toma con movimiento de cámara (drone-wide, close-up, tracking).
• omniflow_produce_movie: Pasa un guion completo como array de tomas ordenadas para producir un cortometraje completo de forma secuencial.
• omniflow_create_character: Bloquea una etiqueta de personaje con consistencia de frente y perfil.
• omniflow_list_jobs: Lista trabajos de generación activos, en cola y finalizados con rutas de descarga en disco.

---

💡 Mejores Prácticas para Prompts Cinematográficos

Para salidas de video fotorrealistas con Veo 3.1:

1. Especifica Movimiento de Cámara: Ej. [Cámara: drone-wide], [Cámara: push-in lento], [Cámara: travelling shot].
2. Especifica Iluminación y Atmósfera: Ej. iluminación de borde volumétrica, bruma anamórfica de hora dorada, grano de película 35mm.
3. Evita Jerga Técnica: Google Flow responde mejor a descripciones narrativas visuales claras que a etiquetas de software.

Consulta references/api-reference.md y examples/cinematic-short-film.json para plantillas listas para ejecutar de múltiples escenas.