Generador de Storyboards (Guiones Gráficos)
Refina la línea argumental a partir de la descripción del usuario, la divide en un guion gráfico (storyboard) y genera ilustraciones de storyboard en lote con un estilo coherente.
Flujo de Trabajo
Fase 1: Refinamiento de la Historia y División en Storyboard
- Recibir la Historia - Obtener el contenido de la historia descrito por el usuario (texto, esquema o fragmento de inspiración).
- Refinar la Línea Argumental - Completar los detalles narrativos, ordenar el arco emocional y generar un resumen estructurado de la historia:
Resumen de la Historia: Resumen en una frase Arco Emocional: [Inicio] → [Giro] → [Desenlace] - Dividir en Storyboard - Dividir la historia en 6-10 fotogramas clave, cada uno con:
- Título de la escena
- Tipo de plano (general/medio/primer plano/extremo primer plano, etc.)
- Descripción visual (acción de los personajes, entorno, iluminación)
- Tono emocional
- Diálogo/texto (si lo hubiera)
- Mostrar el Guion Gráfico - Presentarlo en formato de tabla, esperando la confirmación o ajuste del usuario.
Formato de visualización:
## Guion Gráfico
| # | Escena | Plano | Descripción Visual | Emoción |
|---|--------|-------|--------------------|---------|
| 1 | Apertura | General | xxx | Tranquilidad |
| 2 | Introducción | Medio | xxx | Curiosidad |
| ... |
Fase 2: Selección de Estilo
Una vez confirmado el guion gráfico, mostrar 8 estilos visuales (leer references/visual-styles.md):
| # | Estilo | Característica en una Frase | Historia Adecuada |
|---|---|---|---|
| 1 | Cómic Cyberpunk | Neón + tonos oscuros + alto contraste | Tecnología/IA/Futuro |
| 2 | Acuarela Estilo Ghibli | Acuarela suave + luz cálida | Cotidiano/Cálido/Crecimiento |
| 3 | Ilustración Plana Americana | Geométrica vectorial + colores vivos | Producto/Negocio/Educación |
| 4 | Boceto de Storyboard Cinematográfico | Dibujo en blanco y negro + anotaciones de cámara | Guion de vídeo/Publicidad |
| 5 | Arte Pixelado | Estilo retro 16 bits | Juegos/Diversión/Geek |
| 6 | Tinta China Estilo Shui-mo | Manchas de tinta + espacios poéticos | Tradición/Filosofía/Oriental |
| 7 | Cómic de Línea Clara | Líneas gruesas uniformes + colores planos | Aventura/Humor/IP |
| 8 | Arte Conceptual Realista | Pintura digital de nivel cinematográfico | Épico/Ciencia Ficción/Fantasía |
Según el tipo de historia y el tono emocional, recomendar 1-2 estilos más adecuados y explicar el motivo, esperando la selección del usuario.
Fase 3: Generación de Prompts
Una vez seleccionado el estilo por el usuario, generar prompts para cada fotograma del storyboard.
Estructura de cada prompt (leer references/visual-styles.md para obtener el prefijo de estilo y el lenguaje de cámara):
- Prefijo de Estilo - Descripción estándar del estilo seleccionado
- Instrucción de Cámara - Ej. "Plano general de establecimiento" / "Primer plano"
- Narrativa Visual - Descripción completa de la escena en oraciones completas (personajes, acción, entorno, iluminación, atmósfera)
- Instrucción Emocional - Emoción clara que debe transmitir la imagen
- Anclaje de Consistencia -
Importante: Este es el fotograma N de una secuencia de storyboard de TOTAL fotogramas. Mantén exactamente el mismo estilo artístico, paleta de colores, diseño de personajes y coherencia visual. El mismo personaje debe verse idéntico en todos los fotogramas. - Instrucción de Idioma (si es necesario) -
Todo el texto, letreros y diálogos en la imagen deben estar en chino simplificado (简体中文). Los términos técnicos pueden mantenerse en inglés.
Mostrar tabla resumen de prompts, esperar confirmación:
## Resumen de Prompts
| # | Escena | Plano | Estilo | Imagen Central |
|---|--------|-------|--------|----------------|
| 1 | Apertura | General | Cyberpunk | Horizonte urbano... |
| ... |
Confirmar para comenzar la generación (total N fotogramas)
Fase 4: Generación por Lotes
Tras la confirmación, generar fotograma por fotograma llamando al script:
python3 scripts/generate_image.py \
--prompt "prompt" \
--output "/Users/ugreen/Documents/obsidian/09image/MMDD-nombre-historia-storyboard/01-nombre-escena.png" \
--api-key "AIzaSyDvvGGRbH4Os3Er0dYi0kE_AzE3_2b_Az8" \
--api-url "https://generativelanguage.googleapis.com" \
--model "gemini-3-pro-image-preview" \
--aspect-ratio "16:9" \
--resolution "2K"
Notas importantes:
- El storyboard por defecto es horizontal 16:9
- Resolución por defecto 2K
- MMDD es la fecha del día
- Nombre de archivo:
01-abreviatura-escena.png,02-abreviatura-escena.png... - Intervalo de 2-3 segundos entre fotogramas para evitar limitación de velocidad
- Registrar los fotogramas fallidos y continuar, informar al final
- Crítico: La descripción de la apariencia de los personajes debe ser coherente en todos los fotogramas (peinado, vestimenta, complexión)
Fase 5: Visualización e Iteración
- Una vez completada la generación, listar todas las rutas de los fotogramas en orden.
- Preguntar al usuario:
- "¿Estás satisfecho con el ritmo general de la historia?"
- "¿Necesitas regenerar algún fotograma?"
- "¿Necesitas añadir/eliminar alguna escena?"
- "¿Estás satisfecho con la coherencia de los personajes?"
- Iterar: ajustar los prompts y regenerar los fotogramas especificados.
Especificación de Ruta de Guardado
/Users/ugreen/Documents/obsidian/09image/MMDD-nombre-historia-storyboard/
├── 01-apertura-general.png
├── 02-introduccion-medio.png
├── 03-giro-primer-plano.png
├── 04-desarrolloA-medio.png
├── 05-desarrolloB-panoramica.png
├── 06-climax-extremo-primer-plano.png
├── 07-desenlace-general.png
└── storyboard-script.md (opcional: guardar el documento del guion gráfico)
Configuración de la API
| Elemento de Configuración | Valor |
|---|---|
| URL de la API | https://generativelanguage.googleapis.com |
| Clave de API | AIzaSyDvvGGRbH4Os3Er0dYi0kE_AzE3_2b_Az8 |
| Modelo | gemini-3-pro-image-preview |
| Relación de aspecto predeterminada | 16:9 (storyboard horizontal) |
| Resolución predeterminada | 2K |
Referencia Rápida de Lenguaje de Cámara
| Plano | Término en Inglés | Uso |
|---|---|---|
| Gran Plano General | Wide Shot | Apertura, establecer entorno |
| Plano Entero / Panorámica | Full Shot / Long Shot | Personaje completo + entorno |
| Plano Medio | Medium Shot | Diálogo, interacción cotidiana |
| Primer Plano | Close-Up | Expresión facial, emoción |
| Extremo Primer Plano | Extreme Close-Up | Objeto clave, detalle |
| Picado | High Angle / Bird's-Eye View | Visión general, sensación de pequeñez |
| Contrapicado | Low Angle | Autoridad, impacto |
Uso Común
| El Usuario Dice | Acción |
|---|---|
| "Dibújame un storyboard" | Recopilar historia → Refinar → Dividir en storyboard → Seleccionar estilo → Generar |
| "Convierte esta historia en un storyboard" | Igual que arriba |
| "Dibuja esta historia con estilo cyberpunk" | Saltar selección de estilo, usar el estilo especificado directamente |
| "El fotograma 3 no está bien, regenéralo" | Ajustar el prompt y regenerar ese único fotograma |
| "Añade un fotograma de transición" | Insertar un nuevo fotograma de storyboard en la posición especificada |