Storyboard Reel
Convierte un storyboard dibujado a mano, algunos renders de un personaje low poly y el producto en un anuncio 9:16 de aproximadamente 28 segundos con música y efectos de sonido. Sin narración, sin subtítulos sobre la acción.
Motor: python3 scripts/storyboard_reel.py <comando> <trabajo>, ejecutado desde la raíz del repositorio
(la carpeta que contiene scripts/). --help lista todos los comandos. La lógica está en
scripts/sr_lib.py (tipos de plano, valores predeterminados, temporización, comprobaciones), sr_shots.py (dibujo),
sr_matte.py (recortes), sr_media.py (ffmpeg, rembg, servidor de medios). En Windows usa
python en lugar de python3.
Punto de partida: skills/storyboard-reel/job_template.json. new lo copia dentro del trabajo.
Su ejemplo es un reel de figura y resplandor. Un reel centrado en cámara se construye a partir de planos clip.
El formato
- 9:16, aproximadamente 28 segundos. La pista de música define la duración.
- Tipos de plano que dibuja el motor:
logo(sobre negro),black,dolly(acercamiento a una figura),pose(mantener),clip(un movimiento de imagen a video),glow(la luz de un accesorio se acumula y explota),white,shirt(camiseta blanca sobre blanco, el diseño aparece gradualmente, título debajo),card(título, maqueta, precio, tallas, colores, sitio),still(imagen clave a pantalla completa) yscan(una búsqueda a través de un visor). - Reordena, repite o elimina tipos para seguir el storyboard. Un panel que ningún tipo pueda dibujar necesita una
nueva función de dibujo en
sr_shots.pymás una prueba. Dilo antes de construir alrededor de él. - Aspecto VHS:
"vhs": 0.5en job.json (0 desactivado, 1 completo). Se sitúa en la sección del personaje y desaparece gradualmente en el destello blanco, para que la camiseta y la tarjeta vuelvan limpias. Convhsactivado, el entregable principal esfinal_9x16_vhs.mp4.
Entradas
- Una carpeta con las páginas del storyboard y tus renders de la figura (uno por pose). Nombra
los archivos con
logo,mockupoboarden el nombre y serán detectados. Añade el logo sobre blanco y una maqueta del producto si los tienes. - La URL de la página del producto.
newlee el.jsonde Shopify de la página para el título, precio, tallas y colores. - Para la revelación, una foto de la parte trasera sobre un fondo claro y liso. Si no se establece, se usa la primera imagen de la tienda. A menudo es una maqueta recargada, así que cámbiala por una limpia.
Flujo de trabajo
- Nuevo trabajo.
python3 scripts/storyboard_reel.py new <url-producto> <carpeta-imágenes> [--word <tema>] [--title "<título>"]Copia las imágenes ensrc/, las imágenes de la tienda enproduct/, y rellena el texto de la tarjeta.--wordtermina el nombre de la carpeta del trabajo con una palabra temática. - Editar job.json a partir del storyboard. Asigna cada panel a un plano, establece
panelpara que coincida con el storyboard, asigna cada render a una figura, y escribe el prompt de la placa. Se completa cuandopython3 scripts/storyboard_reel.py check <trabajo>imprime la línea de tiempo sin problemas. - Recortes (reels de figura):
cutouts <trabajo>, luego abrework/cut/feet_check.jpg. rembg puede eliminar hueso pálido sobre suelo pálido y conservar la sombra proyectada. Arregla cada pie con cuadrosfigures.<nombre>.feeten píxeles fuente (addrestaura píxeles pálidos,dropelimina sombra oscura del suelo,rebuildrededuce el cuadro). Vuelve a ejecutar hasta que cada pie esté completo. - Placa.
plate <trabajo> --n 3hace candidatos de fondo en el servidor de medios (gratuito). Revisawork/bg/plates.jpgy estableceplate.srcal que encaje. Mantén "suelo amplio, vacío y plano en primer plano" en el prompt, porque las figuras se colocan enlook.feet_y. También puedes establecerplate.srccon tu propia imagen. - Hoja de contacto, la primera puerta.
stills <trabajo>escribework/contact_sheet_9x16.jpg. Comprueba que los pies se apoyen en el suelo, que la figura no tape la barra inferior de la interfaz y que el texto de la tarjeta sea correcto. Muestra al usuario la hoja y el coste estimado de los clips. Detente y espera. - Clips, solo después de la luz verde del usuario.
kling-frames <trabajo>escribework/kling/<plano>_start.jpg(más_end.jpgdonde el clip tenga un fotograma final) e imprime cada prompt. Sube los fotogramas a tu servicio de imagen a video (OpenArt: sube, cotiza conopenart_model_cost, luego genera), bajo una línea AUTH en~/video-studio/relay/auth.md. Guarda la descarga, luegoprep-clip <trabajo> <descarga.mp4> --shot <id>. La duración del clip define la duración de su plano. - Previa, la segunda puerta.
preview <trabajo>renderiza el tramo del clip con sonido enwork/preview_clip.mp4. Revisa el movimiento fotograma a fotograma, vuelve a ejecutarstills, y luego muestra al usuario la previa y la nueva hoja. Detente y espera. - Copias para publicación. Escribe
posten job.json: uncaptioncorto, luegoinstagram,tiktok,youtube(título y descripción),facebook,hooks,ordery una notacover. El motor añade el bloque de firma fijo desr_post.pya cada caption. Edita ese bloque para tu marca. Se completa cuandokit <trabajo>no imprime líneas de "copias no listas". - Aprobar y renderizar. Después de la luz verde del usuario:
approve <trabajo>, luegorender <trabajo>. Esto escribeout/final_9x16_vhs.mp4(la copia con cinta, más lenta),out/cover.jpg,out/post.txtyout/posts.md. Luegorender <trabajo> --cleanescribe la versión limpiaout/final_9x16.mp4. Cada render también escribe un gemelo_nomusic(efectos de sonido, sin pista musical). Revisa la línea1080x1920 30/1 <duración>s, audio, luego extrae fotogramas en los cortes.--out <ruta>hace un render lateral que dejaout/y el estado del trabajo intactos. - Subir.
upload <trabajo>envía los archivos finales, gemelos, portada y kit de publicación a tu almacenamiento CDN (BunnyCDN, claves enconfig.env). Se niega si las copias tienen captions vacíos o<placeholders>sobrantes. Una re-subida va a un nuevo nombre (_v2) porque los CDN siguen sirviendo el archivo antiguo en una ruta reutilizada. Dale al usuario las nuevas URLs y pega los captions por plataforma desdeposts.md. La publicación es paso del usuario.
La puerta de previa (aplicada en código)
render está bloqueado hasta approve, y approve solo funciona sobre una hoja hecha con el
trabajo actual. Cualquier cambio en la imagen invalida la aprobación: planos, figuras, placa, aspecto,
recortes, un nuevo clip, o cualquier ruta en la parte visual de job.json. Ediciones de audio y copias
no la invalidan. Después de un cambio de imagen, haz una hoja nueva y muéstrala de nuevo.
render --no-preview es solo para la renuncia explícita del usuario en ese trabajo concreto.
Movimiento centrado en cámara
Los planos de movimiento son clips de imagen a video centrados en cámara, escritos como tomas de metraje real: un rig de cámara y lente, un movimiento de cámara con "no es un zoom, no es un corte", luego la acción. Empieza con la capa de baja resolución. Los planos fijos con zooms lentos parecen una presentación de diapositivas.
- Solo fotograma de inicio: la cámara es libre (dolly, arco, avance).
- Un acercamiento que debe aterrizar en una pose: añade un fotograma final, un recorte de la pose final a aproximadamente 1.12x. El acercamiento entonces aterriza exactamente allí. Un primer plano solo de inicio puede cortar la cabeza.
- Un clip fijo (
clipcon rutas de imagenstartyend) debe seguir a un fijo cuyosrcsea su fotograma de inicio. "in": 1.0omite el primer segundo de un clip.dur: "clip"toma la duración real del clip, y el planofillabsorbe la diferencia."gain"oscurece un clip."lights_out": {"at": 2.8, "flicker": 0.7, "floor": 0.04}hace parpadear la luz y cae a casi negro, hecho en la edición sin coste. Combínalo con un efecto de sonido a juego.- Mantén la amenaza fuera de pantalla. Oscuro e invisible da más miedo que una criatura en pantalla.
- Mantén los disparos fuera de pantalla: corta a negro y deja que el sonido los transmita. Los modelos disparan armas incluso cuando se les dice que no, así que revisa los clips de armas fotograma a fotograma y termina el plano antes de cualquier disparo.
- Redacción del prompt para el modelo de video:
- Un movimiento lento y continuo. Nombra lo que permanece quieto (cuerpo, pies, fondo).
- Di cómo se comportan los accesorios ("el bastón se mantiene erguido y nunca se balancea"). Evita "balancear".
- Describe lo que debe aparecer. Las negaciones ("sin niebla") a menudo se ignoran, así que muestra menos.
- Cuando el accesorio se mueve, todo el cuerpo se mueve con él: peso, torso, cabeza. Pies plantados.
- Un primer plano necesita respiración lenta y una pequeña inclinación durante la mayor parte del clip, luego un movimiento rápido. Sin eso parece congelado.
- Duración del clip: de 3 a 5 segundos. Los clips más largos le dan al modelo espacio para divagar.
Perillas de edición (gratuitas, dibujadas en la edición)
"fade_in"funde un clip desde negro."flash"añade un destello blanco cortado en él."handheld"(0 a 1) mueve los planos fijos. Úsalo 0 en clips de cámara, que llevan su propia cámara.scanes una búsqueda a través de un visor, como plano propio, sobre un fijo amplio. Nunca uses un paneo de modelo de video para ello, porque un paneo se desliza como un slider:{"kind": "scan", "dur": 4.4, "src": "<fijo amplio>", "span": 0.236, "scope": {"radius": 0.445, "sway": 16, "steady": 2.4}, "path": [[0.0, 0.13, 0.24], [3.2, 0.645, 0.345]]}Cada punto de ruta es[segundos, x, y]sobre el fijo. La mira persigue la ruta con un muelle, por lo que sobrepasa, corrige y aterriza en el último punto. Dile al modelo de video "sin círculo, sin retícula" si se muestra un clip a través de un visor. La edición dibuja el anillo."live"en un scan reproduce un clip amplio dentro del fijo desde un segundo dado, para que un sujeto se mueva a velocidad real cuando el lente lo encuentra. Úsalo para eliminar una pausa.- Un movimiento mecánico pequeño que el modelo no hará (un gatillo, un interruptor): ajústalo en la edición a partir del fotograma clave. Corta la parte móvil como un polígono, rellena detrás, gírala sobre su junta con un empuje lento. Recorta para que el movimiento llene el teléfono.
shirt"from_black": 1.0, "from_white": 0desvanece la revelación desde negro cuando el storyboard no tiene blanco.
Planos fijos a pantalla completa y fotogramas clave
Úsalos cuando no haya renders de figura, o el storyboard tenga primeros planos y tomas en primera persona.
- Un plano
stilltoma una imagensrca pantalla completa, conpush,anchor[x, y],fade_in,fade_outyflash. - Los fotogramas clave vienen de un modelo de edición de imágenes, 9:16. Dale la hoja del personaje y la escena como referencias, primero la hoja. En una configuración probada solo las dos primeras referencias llegaron al modelo, así que mantén las importantes primero.
- El fotograma final de un clip es una edición de su fotograma inicial ("la misma imagen, solo que..."), para que ambos coincidan. Un cambio pequeño es más rápido como edición local en código que como edición del modelo.
- Un primer plano coincide con la vista de la hoja: una toma lateral es el perfil real de la hoja.
- Un cráneo de perfil mantiene proporciones reales (un cráneo redondo sobre una cara corta). Una capucha sigue el cráneo y cubre la parte superior y trasera. Dilo en el prompt.
- Juzga el tocado por su contorno lateral. Describe el contorno ("corto, redondo, termina en la parte trasera de la cabeza"). Palabras como "alto" o "puntiagudo" hacen que los modelos generen un gorro de mago.
- Una mano mide aproximadamente lo alto que es el cráneo. Para manos esqueléticas, nombra los huesos de los dedos por separado. "Grueso rechoncho" solo da un puño.
- Una toma de apertura comienza alta y amplia sobre todo el set, luego baja a la figura. Haz primero el fotograma amplio y toma el fotograma final cercano como un recorte de él. Una edición que dice "la cámara se ha movido" tiende a escalar la figura en su lugar.
Tablero de borrador gratuito primero
Antes de cualquier llamada paga, bosqueja cada panel en el servidor de medios (FLUX, unos 8 segundos cada uno)
en work/keys/, luego ejecuta stills. El usuario ve todo el corte gratis. Un boceto no
mantiene un personaje, así que dilo cuando lo muestres. Los fotogramas clave pagados reemplazan los bocetos.
Con un personaje nuevo, la hoja del personaje es la primera llamada paga. Cada fotograma clave entonces toma
esa hoja como su primera referencia.
Mantén una dirección de pantalla por personaje (refleja un boceto si mira hacia el lado equivocado). Los personajes recurrentes se cortan a partir de sus fotogramas clave reales, nunca de un boceto.
Mantén cada personaje recurrente en assets/characters/<nombre>/ con un README: la hoja, las
reglas de vestuario, los sets que usan. Lee el README antes de cualquier fotograma clave.
Música y sonido
- Pista musical: instrumental, de aproximadamente 30 segundos, escrita contra la línea de tiempo que
checkimprime. Un arco típico: un golpe en el logo, una pista sombría bajo el dolly, una construcción creciente a través del clip y el glow, la caída en el blanco, un golpe final en la tarjeta. Genérala con ElevenLabs music, o usa tu propia pista con licencia. Guárdala enassets/music/<nombre>.mp3y pon el prompt enaudio.prompt. - Los efectos de sonido viven en
assets/sfx/(impacto, whoosh, riser). Añade entradasaudio.sfxancladas a un plano. Crea una nueva cuando el accesorio cambie. audio.mute: [<ids de plano>]corta la música bruscamente en esos planos y deja los efectos de sonido sonando. Úsalo para "corte a negro, luego disparos".- Las ráfagas de disparos generadas se mezclan en una sola pared de ruido. Genera un disparo limpio y superpone la ráfaga localmente: un estante bajo, un golpe grave descendente bajo cada impacto, pequeños cambios de tono y nivel por impacto, luego un limitador.
Costes
Las placas, recortes y el render local son gratuitos. Los fotogramas clave pagados, clips (OpenArt o similar)
y la música y efectos de sonido de ElevenLabs cuestan créditos. Cotiza cada llamada primero, y mantén la
línea AUTH en ~/video-studio/relay/auth.md cubriéndolo.
job.json, en resumen
length (el punto de corte de la música), product (url, título, precio, tallas, colores), plate
(src, prompt), figures (nombre a src, feet opcional, centre_on), shots (una lista
de id, kind, dur, panel y claves específicas del tipo), vhs, handheld,
audio (music, prompt, music_gain, fade_out, mute, sfx), post (texto para cada
plataforma), y un look opcional. Los valores predeterminados por tipo viven en SHOT_DEFAULTS en sr_lib.py.
El texto en pantalla acepta {title}, {details} y {site}.
Errores comunes
- rembg es necesario para los recortes:
pip install rembg. El comandocutoutsdice lo que falta y cómo configurarlo. - El glow encuentra un orbe magenta por color. Para otro accesorio, establece
light.at([x, y, r], fracciones del cuadro de la figura) ylight.rgb. Revisa precio y tallas contra la página en vivo. - ffmpeg debe estar en tu PATH. Todo el texto en pantalla se dibuja con Pillow, por lo que ffmpeg no necesita el filtro drawtext.