Analizar Video → Plantilla de Prompting Reutilizable
Encontraste un estilo de video que te encanta. Tu trabajo es descomponerlo en una plantilla de prompting reutilizable — una fórmula en la que puedas insertar cualquier producto, persona o entorno y obtener ese mismo estilo de Seedance 2.0.
Restricción crítica: Seedance 2.0 tiene un máximo de 15 segundos por clip. El video de referencia puede ser más largo de 15 segundos (a menudo de 30 a 60 segundos). Tu plantilla debe estar diseñada para una salida de 15 segundos — lo que significa destilar la esencia del estilo en lo que se puede capturar en un solo clip de 15 segundos y proporcionar una estrategia multi-clip para recrear el efecto completo de estilos de formato largo a través de una serie de clips.
El resultado NO es un solo prompt. Es una plantilla de habilidad guardada en skills/arcads-external-api/prompting/prompt-library/ que funciona de la misma manera que seedance-2-ugc.md — una fórmula documentada con capas, variables, opciones y ejemplos que el agente puede usar para generar prompts ilimitados en ese estilo.
Dependencias
- ffmpeg / ffprobe — requeridos para la extracción de fotogramas (Paso 1). Instala con
brew install ffmpegen macOS. - whisper — opcional, para la transcripción de audio (Paso 2). Instala con
pip3 install openai-whisper. Si no está disponible, el agente puede pedir al usuario que proporcione el diálogo manualmente.
Entradas
- Archivo de video (requerido): ruta a
.mp4,.mov,.webmo similar - Nombre del estilo (opcional): cómo llamar a esta plantilla (ej., "reseña-de-coche", "unboxing-emocionante", "escéptico-convencido"). Si no se proporciona, lo nombrarás según lo que observes.
Paso 1: Extraer fotogramas y audio
Ejecuta el script de extracción:
bash "skills/arcads-external-api/prompting/analyze-video/scripts/extract-frames.sh" "<video_path>" "/tmp/video-analysis" <num_frames>
Recuento de fotogramas según la duración:
- Menos de 10s → 8 fotogramas
- 10-20s → 12 fotogramas
- 20-30s → 16 fotogramas
- Más de 30s → 20 fotogramas
Lee metadata.txt para obtener duración, resolución y fps.
Paso 2: Transcribir audio
Prueba las herramientas de transcripción en este orden:
- CLI de
whisper:whisper /tmp/video-analysis/audio.wav --model base --output_format txt --output_dir /tmp/video-analysis - Python whisper: script rápido en línea
- Si no hay nada disponible, pide al usuario que proporcione el diálogo o instale whisper (
pip3 install openai-whisper)
La transcripción te ayuda a entender el ritmo, la cadencia del habla, el uso de muletillas y cómo el diálogo se intercala con la acción — todo lo cual define el estilo.
Paso 3: Estudiar las plantillas de referencia
Lee las plantillas de prompting existentes de Seedance 2.0 para entender el estándar de oro de cómo debe estructurarse una plantilla:
- seedance-2-ugc.md — fórmula UGC de 9 capas (ejemplo más rico)
- seedance-2-premium-reveal.md — revelación de vacío oscuro de 6 capas
- seedance-2-product-hero.md — héroe de producto elemental de 6 capas
- seedance-2-studio-lookbook.md — lookbook de estudio de 7 capas
- seedance-2-feature-walkthrough.md — demo de funciones de 7 capas
También lee la guía principal del modelo para las reglas de la plataforma:
- seedance-2.md — parámetros de API, longitud del prompt, palabras prohibidas, lista de verificación de adaptación
Observa la estructura que comparten estas plantillas:
- Identifican capas (los bloques de construcción estructurales del estilo)
- Cada capa tiene un patrón (la estructura de oración repetible con
{{VARIABLES}}) - Las variables vienen con bancos de opciones (tablas de elecciones que se ajustan al estilo)
- Hay reglas y principios que explican por qué ciertas elecciones importan
- Hay ejemplos completos que muestran la plantilla completamente rellenada
Tu plantilla de salida debe alcanzar el mismo nivel de profundidad y usabilidad.
Paso 4: Analizar los fotogramas — identificar qué define este estilo
Lee TODOS los fotogramas extraídos. No estás describiendo un video específico — estás identificando los patrones transferibles que hacen que este estilo sea lo que es.
Pregúntate por cada dimensión: "¿Qué de esto es específico de ESTE VIDEO (la persona, el producto, el entorno) vs. qué es EL ESTILO (el enfoque, la estructura, la sensación)?"
Solo el estilo va a la plantilla. Los detalles específicos se convierten en variables.
Estructura y ritmo
- ¿Cuánto dura el video? (El video fuente a menudo tendrá de 30 a 60 segundos, lo cual está bien — comprimirás el estilo para una salida de 15 segundos.)
- ¿Cuántas escenas/tiempos distintos hay? ¿Cuáles 2-3 son los tiempos ESENCIALES que definen el estilo?
- ¿Cuál es el arco narrativo? (gancho → demo → prueba → veredicto? ¿o algo diferente?)
- ¿Cuál es el ritmo — cortes rápidos o tomas largas? ¿Cuánto dura cada tiempo?
- ¿Hay tiempos en silencio o es todo diálogo?
- Pregunta de compresión a 15 segundos: Si tuvieras que capturar toda la sensación de este video en solo 3 tiempos y 2-3 líneas habladas, ¿qué momentos conservarías?
Cámara y encuadre
- ¿Cuál es la perspectiva de filmación principal? (selfie, teléfono apoyado, otra persona filmando, grabación de pantalla, etc.)
- ¿Cómo cambia el encuadre entre tiempos? (más cerca, más abierto, diferente ángulo, mismo ángulo en todo momento)
- ¿Hay un movimiento de cámara o una elección de encuadre característico que defina este estilo?
Estilo de edición
- ¿Cortes de salto entre tomas? ¿Toma continua? ¿Time-lapse? ¿Pantalla dividida?
- ¿Cómo funcionan las transiciones? ¿Cortes directos, fundidos, superposiciones de texto?
- ¿Hay motivos visuales recurrentes? (primeros planos del producto, cara de reacción, antes/después)
Diálogo y estructura del guion
- ¿Cuál es el formato del gancho? (pregunta, afirmación audaz, en medio de la acción, reacción)
- ¿Cómo está estructurado el diálogo? (con guion, improvisado, voz en off, texto en pantalla)
- ¿Qué patrones de habla definen el tono? (muletillas, longitud de oraciones, nivel de vocabulario)
- ¿Cómo se relacionan las líneas habladas con las acciones en pantalla?
Tono y energía
- ¿Qué 3-4 palabras de emoción capturan la vibra?
- ¿Cómo cambia la energía a lo largo del video? (aumenta, se mantiene plana, alcanza un pico y luego baja)
- ¿Cuál es la relación con el espectador? (hablando con un amigo, dirigiéndose a seguidores, pensando en voz alta)
Iluminación y calidad técnica
- ¿Cuál es el enfoque de iluminación? (natural, anillo de luz, ambiental, sobreexpuesta)
- ¿Calidad de teléfono o pulida? ¿Qué "defectos" técnicos son parte de la estética?
- Calidad de audio — micrófono de teléfono, de solapa, voz en off, ambiente?
¿Qué hace que este estilo sea DIFERENTE?
Este es el análisis más importante. Después de catalogar todo lo anterior, identifica las 2-3 cosas que hacen que este estilo sea distinto de un video UGC genérico o de una reseña de producto genérica. Tal vez sea el ritmo, tal vez sea el formato del gancho, tal vez sea la forma en que se revela el producto, tal vez sea el ritmo de edición. Estos rasgos definitorios se convierten en el núcleo de tu plantilla.
Plan de optimización a 15 segundos
El video fuente casi con certeza es más largo de 15 segundos. Antes de construir la plantilla, planifica cómo se mapea el estilo al límite de 15 segundos de Seedance:
- ¿Cuál es la versión mínima viable de este estilo? Identifica qué tiempos/elementos son esenciales vs. agradables de tener. Un clip de 15 segundos necesita capturar la ESENCIA del estilo — lo que hace que alguien diga "oh, eso es ESE tipo de video."
- ¿Este estilo necesita una estrategia multi-clip? Si el poder del estilo proviene de un arco narrativo (preparación → recompensa) o de un recorrido de funciones, necesita 2-3 clips. Si el estilo se trata más de una vibra o un solo momento, un clip podría ser suficiente.
- ¿Cuántas líneas habladas caben? A un ritmo natural, 15 segundos caben 2-3 oraciones cortas. Cuenta las líneas en la transcripción de origen y determina cuáles llevan la voz del estilo. Esas van a las reglas de diálogo de la plantilla.
- ¿Cuál es la estructura de tiempos? 15 segundos = máximo 2-3 tiempos. Mapea la estructura de tiempos del video fuente a un esqueleto de 3 tiempos: gancho → momento central → remate.
Paso 5: Construir la plantilla
Crea un nuevo archivo markdown estructurado como una habilidad de prompting reutilizable. El archivo debe ser autónomo — alguien debería poder leerlo y generar prompts en este estilo sin haber visto nunca el video original.
Estructura de la plantilla
# [Nombre del Estilo] — Seedance 2.0
**Usar cuando:** [describe el tipo de video que produce esta plantilla]
**Guía del modelo:** Lee [seedance-2.md](seedance-2.md) primero para conocer las reglas de la plataforma, los parámetros de API y la lista de verificación de adaptación.
## Qué define este estilo
[2-3 párrafos que explican qué hace que este estilo sea distintivo y por qué funciona.
Esta es la sección de "teoría" — ayuda al escritor de prompts a entender el estilo
intuitivamente para que pueda tomar buenas decisiones de variables, no solo llenar espacios en blanco.]
## La estructura
[Identifica las capas/bloques de construcción de ESTE estilo. No fuerces el modelo UGC de 9 capas
si este estilo funciona de manera diferente. Si es un estilo de 5 capas, hazlo de 5.
Si es de 12, hazlo de 12. Deja que la estructura real del video impulse la plantilla.]
## Fórmula capa por capa
### Capa N: [Nombre]
[Explica qué hace esta capa y por qué es importante para este estilo.]
**Patrón:**
\```
[La estructura de oración repetible con {{VARIABLES}}]
\```
**Variables:**
| Variable | Opciones | Notas |
|----------|----------|-------|
| `VARIABLE_NAME` | opción 1, opción 2, opción 3 | [guía] |
[Incluye bancos de opciones, consejos y trampas específicas de este estilo]
### [... más capas ...]
## Estructura de tiempos (formato de 15 segundos)
[Detalla el marco de 3 tiempos para un solo clip de 15 segundos en este estilo.
¿Cuál es el tiempo 1 (gancho), tiempo 2 (central), tiempo 3 (remate)? ¿Qué tiempos tienen
diálogo vs. acción en silencio? Máximo 2-3 líneas habladas en total.]
## Estrategia multi-clip (si aplica)
[Si el estilo completo necesita más de 15 segundos, muestra cómo dividirlo en
2-3 clips. Cada clip debe ser independiente con su propia energía de gancho, pero juntos
recrean el estilo completo. Incluye una tabla que muestre qué características/momentos
van en cada clip.]
## Guía de tono y ritmo
[Cómo calibrar la energía, los patrones de habla y el ritmo para este estilo.
Incluye un banco de señales de ritmo específico de este estilo.]
## Especificaciones técnicas
[Iluminación, calidad de cámara, características de audio que definen el aspecto y la
sensación de este estilo. Incluye los "defectos" específicos que lo hacen auténtico.]
## Plantilla completa
[Un bloque de copiar y pegar para UN clip de 15 segundos con TODAS las variables
marcadas como {{PLACEHOLDERS}}. Máximo 3 tiempos, máximo 2-3 líneas de diálogo.
Esta es la unidad central — cada prompt generado a partir de esta plantilla
produce un clip de 15 segundos de Seedance.]
## Prompts de ejemplo
[Muestra un ejemplo multi-clip (2-3 clips) usando un producto/persona/entorno DIFERENTE
al video fuente. Cada clip es un prompt completo de 15 segundos. Juntos demuestran
cómo funciona el estilo en una serie.]
## Lista de verificación de adaptación
[Una lista de verificación rápida para verificar que todas las capas estén cubiertas antes de enviar
el prompt. Incluye siempre las comprobaciones estándar de Seedance 2.0 de seedance-2.md.]
Principios clave para la plantilla
-
Cada prompt es de 15 segundos. Esta es una restricción estricta de Seedance 2.0. La plantilla debe producir prompts que quepan dentro de 15 segundos — máximo 3 tiempos, máximo 2-3 líneas habladas. Si el estilo necesita más, la plantilla debe incluir una estrategia multi-clip que muestre cómo dividir en 2-3 prompts separados de 15 segundos.
-
Las variables deben ser elecciones significativas, no espacios en blanco abiertos. Para cada variable, proporciona un banco curado de opciones que se ajusten a este estilo. "Cualquier iluminación" es inútil. "Luz de ventana natural, luz de cocina superior, luz de balcón al atardecer" da una guía real.
-
Captura las reglas, no solo la estructura. Si el gancho tiene que ser una pregunta, dímelo. Si debe haber exactamente un tiempo en silencio, dímelo. La plantilla debe hacer que sea difícil escribir un prompt malo.
-
Los prompts de ejemplo deben usar contenido DIFERENTE al video fuente. Si el video fuente era una mujer reseñando un sérum en su dormitorio, el ejemplo debería ser un chico reseñando una barra de proteína en su cocina (o lo que sea). Esto demuestra que la plantilla se generaliza.
-
Incluye una referencia de imagen de producto
@(img1)en el patrón de la plantilla, ya que los prompts de Seedance aceptan referencias de imagen para el producto. -
Preserva la voz del estilo. Si el original usa tipos específicos de muletillas, estructuras de oraciones específicas, patrones de energía específicos — codifica esos en las reglas de diálogo y la guía de tono de la plantilla para que cada prompt generado a partir de ella suene correcto.
-
El diálogo debe caber en 15 segundos. Un humano natural habla ~2-3 oraciones cortas en 15 segundos con pausas. Si el video fuente tiene diálogo denso y rápido, la plantilla debe notar que el ritmo del hablante es rápido y que cada línea debe ser contundente y corta. Cuenta las palabras — 30-40 palabras habladas es el techo realista para 15 segundos.
-
Sigue la guía de la plataforma Seedance 2.0. Todas las plantillas deben cumplir con seedance-2.md — longitud del prompt (100-260 palabras), sin palabras prohibidas ("cinematográfico," "profesional," "impresionante," "8k," "estudio," "perfecto"), especificidad explícita de movimiento y anclajes de consistencia para referencias de producto.
Paso 6: Guardar y presentar
- Guarda la plantilla en
skills/arcads-external-api/prompting/prompt-library/seedance-2-<nombre-del-estilo>.md - Imprime un resumen en la conversación:
- Qué estilo se identificó
- Las capas/estructura clave
- Qué lo hace distintivo
- La ruta del archivo donde se guardó
- Pregunta: "¿Quieres que genere un prompt de prueba usando esta plantilla para asegurarme de que funciona?"
Si dicen que sí, genera un prompt para un producto/persona/entorno diferente al video fuente — esto valida que la plantilla es genuinamente reutilizable.
Paso 7: Enviar a la API de Arcads
Después de generar y guardar un prompt, ofrece enviarlo a Arcads para la generación de video.
Endpoint de API: POST /v2/videos/generate
Cuerpo de la solicitud:
{
"model": "seedance-2.0",
"productId": "<product-uuid>",
"prompt": "<el-prompt-generado>",
"aspectRatio": "9:16",
"duration": 15,
"resolution": "720p",
"audioEnabled": true,
"referenceImages": ["<filePath-from-presigned-upload>"]
}
Antes de enviar:
- Pide al usuario un
productId(o usa el predeterminado) - Pregunta sobre imágenes de referencia del producto
- Muestra un resumen del prompt y confirma que el usuario quiere enviarlo