Habilidad de Generación de Video (video-generation)
Un pipeline completo y de grado de producción para transformar ideas y temas en bruto en videos terminados y pulidos. Combina dirección creativa estructurada (briefing, investigación, escritura de guion, lista de tomas) con ensamblaje local mediante la CLI de MoneyPrinterTurbo (cli.py o alias configurado).
Verificación Previa 1: Disponibilidad de MoneyPrinterTurbo y Resolución del Comando
Antes de ejecutar el pipeline de generación de video, verifica que MoneyPrinterTurbo esté disponible y resuelve el comando de ejecución:
-
Verifica si existe un alias, función o script envolvente configurado:
alias video 2>/dev/null || type video 2>/dev/null || which video 2>/dev/nullSi existe un alias o envoltura
videoen el shell o PATH, úsalo directamente (ej.video [opciones]). -
Si no existe alias ni comando, localiza dinámicamente
cli.pyde MoneyPrinterTurbo:find ~ -name "cli.py" -path "*/MoneyPrinterTurbo/*" 2>/dev/null | head -n 1- Desde el directorio descubierto (ej.
~/Applications/MoneyPrinterTurbo):- Identifica el intérprete de Python del entorno virtual (ej.
<MoneyPrinterTurbo_DIR>/.venv/bin/python). Si no hay.venv, usa elpython3del sistema. - Construye el comando de ejecución directa:
<MoneyPrinterTurbo_DIR>/.venv/bin/python <MoneyPrinterTurbo_DIR>/cli.py [opciones]
- Identifica el intérprete de Python del entorno virtual (ej.
- Desde el directorio descubierto (ej.
[!IMPORTANTE] Si no se puede localizar ni un alias ni
cli.pyde MoneyPrinterTurbo, detente y solicita al usuario que instale MoneyPrinterTurbo primero:"MoneyPrinterTurbo es necesario para el ensamblaje y renderizado de video, pero no se encontró en tu sistema. Por favor, instálalo primero desde https://github.com/harry0703/MoneyPrinterTurbo antes de continuar con la generación de video."
Verificación Previa 2: Estado del Servicio de Ollama (Si se usa LLM Local)
Si la generación de guion está configurada para usar un modelo local o en la nube de Ollama, verifica si el servicio/proceso de Ollama está activo:
systemctl is-active --quiet ollama || pgrep -x ollama > /dev/null
[!IMPORTANTE] Si se necesita Ollama pero no está en ejecución, detente y solicita al usuario que inicie el servicio:
"El servicio de Ollama no está actualmente en ejecución. Por favor, inícialo ejecutando:"
sudo systemctl start ollama(Asegúrate también de que
ollama signinse haya completado si se usan modelos de Ollama Cloud).
Verificación Previa 3: Descubrimiento Dinámico de Habilidades y Planificación
No asumas ni fijes de antemano qué habilidades externas específicas están instaladas en el agente. Otros entornos o usuarios tendrán conjuntos de habilidades diferentes.
En su lugar, inspecciona dinámicamente el entorno, identifica cualquier habilidad instalada que pueda ayudar en el pipeline de video y sintetiza los hallazgos en un Plan de Generación de Video.
1. Localiza e Inspecciona las Habilidades Disponibles
Navega e inspecciona el directorio o configuración de habilidades instaladas del agente. Identifica cualquier habilidad capaz de ayudar con:
- Investigación e Ideación: Descubrimiento de temas, investigación factual, análisis de dominio o búsqueda bibliográfica.
- Redacción y Guion: Formulación de ganchos, escritura creativa, revisión de guiones o perfilado de persona/voz.
- Audio y Voz: Limpieza de audio, análisis de transcripciones, eliminación de silencios o TTS personalizado.
- Visuales y Activos: Renderizado de fragmentos de código, tutoriales de interfaz, diagramas o generación de imágenes.
- Empaquetado y SEO: Evaluación de títulos/miniaturas, metadatos de búsqueda o generación de capítulos de video.
2. Protocolo de Consulta al Usuario (Antes de Planificar)
Antes de crear el Plan de Generación de Video, presenta cualquier habilidad relevante descubierta al usuario para obtener su opinión:
- Haz una pregunta simple de Sí/No (puede ser en un solo mensaje para varias habilidades):
"He encontrado la(s) siguiente(s) habilidad(es) que podrían ayudar con este video:" ": puede ayudar con [tarea específica, ej. evaluación de ganchos/limpieza de audio/capítulos]." ": puede ayudar con [tarea específica]." "¿Te gustaría que use alguna de ellas para este video? (Responde con los nombres de las que quieras usar, o 'Ninguna')"
- Si el usuario elige una o más habilidades: Márcalas como aprobadas para incluirlas en el plan de generación.
- Si el usuario responde 'Ninguna' a todas o rechaza una específica:
Pregunta por qué (puede ser en el mismo mensaje):
"Entendido. ¿Podrías compartir por qué prefieres no usarla(s)?"
- Por qué esto importa: Preguntar "por qué no" descubre restricciones creativas vitales y afina el objetivo principal (ej., "Ya escribí el guion exacto", "Quiero un tono documental serio, no ganchos rápidos", "Mantén las pausas naturales en mi audio").
- Usa sus respuestas para obtener claridad directa sobre sus metas antes de redactar el plan.
3. Formula el Plan de Generación de Video
Una vez completada la consulta al usuario, formula un Plan de Generación de Video personalizado basado en las instrucciones de esta habilidad, los objetivos/restricciones aclarados por el usuario y las habilidades aprobadas:
- Briefing Creativo: Audiencia, plataforma objetivo, duración, relación de aspecto y tono (reflejando las restricciones recopiladas durante la consulta).
- Habilidades Aprobadas Incluidas: Herramientas/habilidades específicas que el usuario aceptó y cómo se usarán.
- Enfoque de Guion y Storyboard: Estrategia de gancho, puntos clave y estructura planificada de la lista de tomas.
- Fuentes de Medios y Audio: Voz en off (Edge TTS vs. audio local), volumen de BGM y activos visuales (metraje local vs. stock).
- Ensamblaje de la Línea de Tiempo: Ritmo, animación de subtítulos, transiciones y especificaciones de renderizado final.
El Pipeline de Tema a Video
flowchart TD
A["1. Inspeccionar Habilidades Disponibles en el Entorno"] --> B{"2. Protocolo de Consulta al Usuario
Preguntar opinión sobre habilidades candidatas"}
B --> C["3. Formular Plan de Generación de Video
(Basado en instrucciones + objetivos aclarados)"]
C --> D["4. Investigación y Escritura de Guion"]
D --> E["5. Lista de Tomas (Storyboard Clave)"]
E --> F["6. Síntesis de Voz (TTS / Audio)"]
F --> G["7. Visuales por Escena (Stock / Local / Movimiento)"]
G --> H["8. Ensamblaje de Línea de Tiempo (CLI de MoneyPrinterTurbo)"]
H --> I["9. Control de Calidad, Metadatos y Entrega Final MP4"]
Instrucciones del Pipeline Paso a Paso
1. Clarificar el Briefing
Antes de generar código o medios, define los parámetros creativos. Si el usuario no los proporciona explícitamente, infiere valores predeterminados sensatos según el tema y la plataforma:
- Audiencia: ¿Quién está viendo? (Público general, estudiantes, desarrolladores, compradores)
- Perfil de Voz y Tono: Verifica si el usuario ha proporcionado una guía de estilo, preferencias de tono o restricciones de persona.
- Duración Objetivo:
- Formato corto: 15s–60s (TikTok, IG Reels, YouTube Shorts)
- Formato medio: 1–3 min (Demostraciones de productos, explicaciones rápidas)
- Explicativo: 3–5 min (Análisis profundos, tutoriales)
- Relación de Aspecto:
9:16(Vertical para móvil / Reels / Shorts / TikTok) — predeterminado16:9(Horizontal para YouTube / escritorio / presentaciones)1:1(Cuadrado para Instagram / publicaciones de LinkedIn)
- Tono: Casual, enérgico, autoritario, narrativo o humorístico.
- Plataforma: Determina el ritmo, tamaños de fuente, estilo de subtítulos e intensidad del gancho.
2. Investigar el Tema
Recopila hechos verificados, ganchos convincentes y puntos de datos precisos:
- Hechos / Eventos Actuales: Usa herramientas de búsqueda para verificar fechas, estadísticas, nombres propios y afirmaciones principales.
- Temas Perennes / Conceptuales: Estructura 3–5 ideas sorprendentes o de alto valor.
- Identifica el Gancho: El ángulo más intrigante para captar la atención en los primeros 3 segundos (aprovechando cualquier habilidad de investigación/ideación aprobada en el plan).
3. Escribir el Guion
Redacta la narración formateada específicamente para audio hablado, no para lectura:
- Regla General de Ritmo: ~130–150 palabras por minuto (~2.2 a 2.5 palabras por segundo). Un corto de 30 segundos necesita ~65–75 palabras; un video de 60 segundos necesita ~130–150 palabras.
- Validación del Gancho: Detén el desplazamiento inmediatamente en los primeros 3 segundos. Si el usuario aprobó herramientas de evaluación de ganchos o redacción, ejecuta los ganchos candidatos a través de ellas antes de finalizar.
- Estructura:
- Gancho (0–3s): Detén el desplazamiento inmediatamente con una pregunta audaz o declaración sorprendente.
- Cuerpo (3–5 puntos clave): Progresa lógicamente a través de los puntos principales. Usa frases contundentes sin cláusulas dependientes densas.
- Cierre / Llamada a la Acción (últimos 3–5s): Conclusión clara o llamada a la acción.
- Evita formato markdown, emojis, paréntesis o citas dentro del texto de la narración hablada.
4. Desglosar el Guion en una Lista de Tomas (El Eje Central)
La lista de tomas conecta el guion con la generación visual y de audio. Divide el guion en escenas (típicamente 3–6 segundos cada una).
[!IMPORTANTE] La Lista de Tomas es el artefacto más crítico. Cuando el texto de la escena, las descripciones visuales y el tiempo están bien estructurados, la generación y el ensamblaje posteriores se vuelven fluidos y deterministas.
Plantilla de Lista de Tomas:
| Escena # | Línea de Narración | Descripción Visual / Términos de Búsqueda | Texto en Pantalla | Duración Est. |
|---|---|---|---|---|
| 1 (Gancho) | "En las profundidades del océano, las criaturas crean su propia luz." | Medusas bioluminiscentes brillando en la oscuridad total del mar profundo | SECRETOS DEL ABISMO | 4s |
| 2 (Punto 1) | "Más del 75% de los animales del mar profundo producen bioluminiscencia." | Señuelo de rape luminoso moviéndose en la oscuridad | 75% DE CRIATURAS | 4s |
| 3 (Punto 2) | "Usan reacciones químicas para comunicarse, cazar y camuflarse." | Primer plano de fotóforos azules pulsando en un calamar | BRILLO NATURAL | 5s |
| 4 (Cierre) | "Síguenos para descubrir más secretos escondidos en el abismo." | Luz de sumergible iluminando un acantilado de trinchera oceánica | EXPLORA MÁS | 3s |
5. Generar la Voz en Off
Sintetiza el habla a partir de la narración.
- Regla de Autoridad de Tiempo: La duración real de los archivos de audio generados (no la duración estimada del paso 4) se convierte en el ancla definitiva de la línea de tiempo para el ritmo de la escena y los cortes visuales.
- En la ejecución unificada, MoneyPrinterTurbo maneja TTS automáticamente a través de Edge TTS (gratuito, alta calidad).
- Para voces en off personalizadas o audio pregrabado, limpia el audio (usando cualquier habilidad de limpieza de audio aprobada) y proporciona
--custom-audio-file <ruta>.
6. Obtener o Generar Visuales por Escena
Empareja los visuales con la duración exacta del audio de cada escena:
- Metraje de Stock: Clips de Pexels, Pixabay o Coverr que coincidan con las palabras clave de la escena.
- Medios Locales: Clips de video o imágenes proporcionados mediante
--video-source local --video-materials "clip1.mp4,clip2.mp4". - Movimiento de Imagen: Cuando se usan imágenes fijas, aplica movimiento dinámico (
--image-motion zoom) para mantener el interés del espectador.
7. Ensamblar la Línea de Tiempo
Une audio, video, subtítulos y música:
- Concatena el metraje según el orden de las escenas (
--video-concat-mode sequentialorandom). - Superpone subtítulos animados sincronizados palabra por palabra (
--subtitle-display-mode word_by_word). - Mezcla música de fondo (BGM) debajo de la narración a un nivel discreto (
--bgm-volume 0.15–0.2). - Aplica transiciones de escena (
--video-transition-mode fade-in,slide-in, etc.).
8. Renderizar, Revisar y Control de Calidad (QC)
Realiza una inspección de control de calidad antes de entregar el video final:
- Tiempo y Sincronización: ¿El cambio visual se alinea con el tema de la voz en off?
- Legibilidad: ¿Los subtítulos son legibles contra el fondo? (Se verificó tamaño de fuente, contraste, borde).
- Mezcla de Audio: ¿La voz se escucha claramente sobre la música de fondo?
- Zonas Seguras: En videos verticales
9:16, ¿las superposiciones de interfaz (como botones de TikTok/Reels) están libres de texto crítico? - Metadatos Complementarios (Opcional): Si se solicita o aprueba en el plan, genera metadatos complementarios para la carga (ej. títulos, etiquetas, descripciones o marcas de tiempo de capítulos).
- Entrega del Proyecto: Transfiere el video final y los activos a
<directorio_del_proyecto>/video-<título_corto>-<fecha_hora>/.
Almacenamiento de Salida y Entrega del Proyecto
Siempre organiza y entrega el video final generado y sus activos en el directorio del proyecto del usuario, en lugar de dejarlos enterrados dentro del almacenamiento interno del motor:
1. Resolución del Directorio del Proyecto
- Verifica si hay un Directorio de Proyecto/Espacio de Trabajo Activo:
- Comprueba si hay un espacio de trabajo activo o directorio de proyecto presente.
- Solicitud de Respaldo si no Existe un Directorio de Proyecto:
- Si no hay un directorio de proyecto o espacio de trabajo establecido/conocido, solicita al usuario la ruta de destino antes de finalizar la entrega:
"No se detectó un directorio de proyecto o espacio de trabajo activo. ¿Dónde te gustaría guardar el video generado? (Proporciona la ruta de la carpeta de destino)"
- Si no hay un directorio de proyecto o espacio de trabajo establecido/conocido, solicita al usuario la ruta de destino antes de finalizar la entrega:
2. Formato de Nombre de la Carpeta de Salida
Dentro del directorio de proyecto resuelto, crea una carpeta dedicada llamada:
video-<título_corto>-<fecha_hora>/
<título_corto>: Un título de 2 a 4 palabras en formato slug (ej.criaturas-mar-profundas,computacion-cuantica).<fecha_hora>: Marca de tiempo actual formateada comoYYYYMMDD-HHMMSS(ej.20261113-171530).- Ejemplo de carpeta:
video-criaturas-mar-profundas-20261113-171530/
3. Entrega y Organización de Activos
Cuando MoneyPrinterTurbo termine de renderizar en el almacenamiento interno de tareas:
- Crea la carpeta con marca de tiempo en el directorio del proyecto:
mkdir -p "<directorio_del_proyecto>/video-<título_corto>-<fecha_hora>" - Copia el video final y los activos generados desde el directorio de tareas del motor (
storage/tasks/<task_id>/) a la carpeta del proyecto:- Video final:
final-1.mp4→<directorio_del_proyecto>/video-<título_corto>-<fecha_hora>/<título_corto>.mp4 - Subtítulos:
subtitle.srt→<directorio_del_proyecto>/video-<título_corto>-<fecha_hora>/subtitles.srt - Audio de voz en off:
audio.mp3→<directorio_del_proyecto>/video-<título_corto>-<fecha_hora>/audio.mp3 - Guion:
script.json→<directorio_del_proyecto>/video-<título_corto>-<fecha_hora>/script.json
- Video final:
- Proporciona al usuario el enlace directo y clickable al archivo
.mp4final dentro de su directorio de proyecto.
Ejecución de Comandos y Salidas de Tarea
El pipeline se maneja a través de la CLI de MoneyPrinterTurbo (cli.py o alias configurado):
- Invocación del Comando:
Ejecuta mediante el alias/comando detectado (si está presente) o directamente usando el intérprete de Python del entorno virtual con
cli.py:# Si existe alias o envoltura: video [opciones] # Ejecución directa mediante python: <Directorio_MoneyPrinterTurbo>/.venv/bin/python <Directorio_MoneyPrinterTurbo>/cli.py [opciones]