Storyboard Reel
Transforma um storyboard desenhado à mão, alguns renders de um personagem low-poly e o produto em um anúncio 9:16 de cerca de 28 segundos com música e efeitos sonoros. Sem narração, sem legendas sobre a ação.
Engine: python3 scripts/storyboard_reel.py <comando> <job>, executado a partir da raiz do repositório
(a pasta que contém scripts/). --help lista todos os comandos. A lógica está em
scripts/sr_lib.py (tipos de tomada, padrões, cronometragem, verificações), sr_shots.py (desenho),
sr_matte.py (recortes), sr_media.py (ffmpeg, rembg, servidor de mídia). No Windows use
python no lugar de python3.
Ponto de partida: skills/storyboard-reel/job_template.json. new o copia para o job.
Seu exemplo é um reel de figura e brilho. Um reel com foco em câmera é construído a partir de tomadas clip.
O formato
- 9:16, cerca de 28 segundos. A faixa de música define a duração.
- Tipos de tomada que a engine desenha:
logo(sobre preto),black,dolly(aproximação em uma figura),pose(pausa),clip(um movimento imagem-para-vídeo),glow(a luz de um adereço se acumula e explode),white,shirt(camiseta branca sobre fundo branco, design aparece gradualmente, título abaixo),card(título, mockup, preço, tamanhos, cores, site),still(imagem chave em tela cheia) escan(uma busca através de uma mira). - Reordene, repita ou remova tipos para seguir o storyboard. Um quadro que nenhum tipo consegue desenhar precisa de uma nova
função de desenho em
sr_shots.pymais um teste. Diga isso antes de construir algo em torno dele. - Look VHS:
"vhs": 0.5no job.json (0 desligado, 1 completo). Ele fica na seção do personagem e desaparece gradualmente através do flash branco, para que a camiseta e o card voltem limpos. Comvhsativado, a entrega principal éfinal_9x16_vhs.mp4.
Entradas
- Uma pasta com as páginas do storyboard e seus renders da figura (um por pose). Nomeie
arquivos com
logo,mockupouboardno nome e eles são capturados. Adicione o logotipo sobre fundo branco e um mockup do produto, se os tiver. - A URL da página do produto.
newlê o.jsondo Shopify da página para obter título, preço, tamanhos e cores. - Para a revelação, uma foto da estampa traseira sobre um fundo claro liso. Se nenhuma for definida, a primeira imagem da loja é usada. Geralmente é um mockup cheio, então substitua por um limpo.
Fluxo de trabalho
- Novo job.
python3 scripts/storyboard_reel.py new <url-produto> <pasta-imagens> [--word <tópico>] [--title "<título>"]Copia as imagens parasrc/, as imagens da loja paraproduct/e preenche o texto do card.--wordtermina o nome da pasta do job com uma palavra de tópico. - Autorar job.json a partir do storyboard. Mapeie cada quadro para uma tomada, defina
panelpara corresponder ao storyboard, atribua cada render a uma figura e escreva o prompt da placa. Concluído quandopython3 scripts/storyboard_reel.py check <job>imprime a linha do tempo sem problemas. - Recortes (reels das figuras):
cutouts <job>, depois abrawork/cut/feet_check.jpg. O rembg pode remover osso claro sobre chão claro e manter a sombra projetada. Corrija cada pé com caixasfigures.<nome>.feetem pixels de origem (addrestaura pixels claros,dropremove sombra escura do chão,rebuildrecalcula a caixa). Repita até que cada pé esteja completo. - Placa.
plate <job> --n 3faz fundos candidatos no servidor de mídia (grátis). Vejawork/bg/plates.jpge definaplate.srcpara a placa adequada. Mantenha "chão largo e vazio no primeiro plano" no prompt, porque as figuras estão emlook.feet_y. Você também pode definirplate.srccom sua própria imagem. - Folha de contato, o primeiro portão.
stills <job>escrevework/contact_sheet_9x16.jpg. Verifique se os pés estão no chão, a figura ultrapassa a faixa inferior da UI e o texto do card está correto. Mostre ao usuário a folha e o custo estimado dos clipes. Pare e aguarde. - Clipes, somente após o sinal verde do usuário.
kling-frames <job>escrevework/kling/<tomada>_start.jpg(mais_end.jpgonde o clipe tem um quadro final) e imprime cada prompt. Envie os quadros para seu serviço imagem-para-vídeo (OpenArt: upload, cotação comopenart_model_cost, depois gerar), sob uma linha AUTH em~/video-studio/relay/auth.md. Salve o download, depoisprep-clip <job> <download.mp4> --shot <id>. A duração do clipe define sua tomada. - Pré-visualização, o segundo portão.
preview <job>renderiza o trecho do clipe com som parawork/preview_clip.mp4. Verifique o movimento quadro a quadro, executestillsnovamente, depois mostre ao usuário a pré-visualização e a nova folha. Pare e aguarde. - Texto de pós-produção. Escreva
postno job.json: umacaptioncurta, depoisinstagram,tiktok,youtube(título e descrição),facebook,hooks,ordere uma notacover. A engine anexa o bloco de assinatura fixo desr_post.pya cada legenda. Edite esse bloco para sua marca. Concluído quandokit <job>não imprime linhas "texto de pós não está pronto". - Aprovar e renderizar. Após o sinal verde do usuário:
approve <job>, depoisrender <job>. Isso escreveout/final_9x16_vhs.mp4(a versão com fita, mais lenta),out/cover.jpg,out/post.txteout/posts.md. Depoisrender <job> --cleanescreve oout/final_9x16.mp4limpo. Cada render também escreve um gêmeo_nomusic(efeitos sonoros, sem faixa musical). Verifique a linha logada1080x1920 30/1 <duração>s, audio, depois extraia quadros nos cortes.--out <caminho>faz um render lateral que deixaout/e o status do job intactos. - Upload.
upload <job>envia os finais, gêmeos, capa e kit de pós para seu armazenamento CDN (BunnyCDN, chaves emconfig.env). Ele recusa enquanto o texto de pós tiver legendas vazias ou<placeholders>restantes. Um re-upload vai para um novo nome (_v2) porque CDNs continuam servindo o arquivo antigo em um caminho reutilizado. Dê ao usuário as novas URLs e cole as legendas por plataforma deposts.md. A postagem é etapa do usuário.
O portão de pré-visualização (imposto no código)
render é bloqueado até approve, e approve funciona apenas em uma folha feita a partir do
job atual. Qualquer alteração na imagem invalida a aprovação: tomadas, figuras, placa, look,
recortes, um novo clipe ou qualquer caminho na parte visual do job.json. Edições de áudio e pós
não a invalidam. Após uma alteração na imagem, faça uma nova folha e mostre-a novamente.
render --no-preview é apenas para a renúncia explícita do usuário naquele job específico.
Movimento com foco em câmera
As tomadas de movimento são clipes imagem-para-vídeo com foco em câmera, escritos como tomadas de filmagem real: um rig de câmera e lente, um movimento de câmera com "sem zoom, sem corte", depois a ação. Comece com o nível de baixa resolução. Stills mantidos com zooms lentos parecem um slideshow.
- Apenas quadro inicial: a câmera está livre (dolly, arco, avanço).
- Uma aproximação que deve pousar em uma pose: adicione um quadro final, um recorte da pose final em cerca de 1.12x. A aproximação então pousa exatamente ali. Um close-up só com início pode cortar a cabeça.
- Um clipe estático (
clipcom caminhos de imagemstarteend) deve seguir um still cujosrcé seu quadro inicial. "in": 1.0pula o primeiro segundo de um clipe.dur: "clip"usa a duração real do clipe, e a tomadafillabsorve a diferença."gain"escurece um clipe."lights_out": {"at": 2.8, "flicker": 0.7, "floor": 0.04}faz a luz falhar e cair para quase preto, feito na edição sem custo. Combine com um efeito sonoro correspondente.- Mantenha a ameaça fora da tela. Escuro e não visto parece mais assustador do que uma criatura na tela.
- Mantenha tiros fora da tela: corte para preto e deixe o som carregá-los. Modelos disparam armas mesmo quando instruídos a não fazer, então verifique os clipes de armas quadro a quadro e termine a tomada antes de qualquer tiro.
- Redação do prompt para o modelo de vídeo:
- Um movimento contínuo e lento. Nomeie o que permanece parado (corpo, pés, fundo).
- Diga como os adereços se comportam ("o cajado permanece ereto e nunca balança"). Evite "balançar".
- Descreva o que deve aparecer. Negações ("sem névoa") são frequentemente ignoradas, então mostre menos.
- Quando o adereço se move, o corpo inteiro se move com ele: peso, tronco, cabeça. Pés plantados.
- Um close-up precisa de respiração lenta e uma pequena inclinação na maior parte do clipe, depois um movimento rápido. Sem isso, parece congelado.
- Duração do clipe: 3 a 5 segundos. Clipes mais longos dão ao modelo espaço para divagar.
Knobs de edição (grátis, desenhados na edição)
"fade_in"faz um clipe aparecer gradualmente a partir do preto."flash"adiciona um flash branco cortado nele."handheld"(0 a 1) balança stills mantidos. Use 0 em clipes de câmera, que carregam sua própria câmera.scané uma busca através de uma mira, como uma tomada própria, em um still amplo. Nunca use um panorama de modelo de vídeo, pois um panorama desliza como um slider:{"kind": "scan", "dur": 4.4, "src": "<still amplo>", "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 ponto do caminho é[segundos, x, y]no still. A mira persegue o caminho como uma mola, então ela ultrapassa, corrige e pousa no último ponto. Diga ao modelo de vídeo "sem círculo, sem retícula" se um clipe é mostrado através de uma mira. A edição desenha o anel."live"em um scan reproduz um clipe amplo dentro do still a partir de um determinado segundo, para que um sujeito se mova em velocidade real quando a lente o encontrar. Use para remover uma pausa.- Um pequeno movimento mecânico que o modelo não fará (um gatilho, um interruptor): monte-o na edição a partir do quadro chave. Corte a parte móvel como um polígono, preencha atrás dela, gire-a em seu eixo sob um empurrão lento. Corte para que o movimento preencha o telefone.
shirt"from_black": 1.0, "from_white": 0faz a revelação aparecer gradualmente a partir do preto quando o storyboard não tem um fade para branco.
Stills em tela cheia e quadros chave
Use estes quando não houver renders de figura, ou quando o storyboard tiver close-ups e tomadas em primeira pessoa.
- Uma tomada
stillusa uma imagemsrcem tela cheia, compush,anchor[x, y],fade_in,fade_outeflash. - Quadros chave vêm de um modelo de edição de imagem, 9:16. Dê a ele a ficha do personagem e a cena como referências, a ficha primeiro. Em uma configuração testada, apenas as duas primeiras referências chegaram ao modelo, então mantenha as importantes primeiro.
- O quadro final de um clipe é uma edição de seu quadro inicial ("a mesma imagem, apenas ..."), para que os dois se alinhem. Uma pequena alteração é mais rápida como uma edição local no código do que como uma edição de modelo.
- Um close-up corresponde à própria visão da ficha: uma tomada lateral é o perfil verdadeiro da ficha.
- Um crânio de perfil mantém proporções reais (um crânio redondo sobre um rosto curto). Um capuz segue o crânio e cobre o topo e a parte de trás. Diga isso no prompt.
- Julgue o cocar pelo seu contorno lateral. Descreva o contorno ("curto, redondo, termina na parte de trás da cabeça"). Palavras como "alto" ou "pontiagudo" fazem modelos de imagem criar um chapéu de bruxo.
- Uma mão tem aproximadamente o mesmo comprimento que a altura do crânio. Para mãos esqueléticas, nomeie os ossos dos dedos separadamente. "Grossa e encorpada" sozinho dá um punho.
- Uma tomada de abertura começa alto e amplo em todo o cenário, depois desce até a figura. Faça o quadro amplo primeiro e pegue o quadro final próximo como um recorte dele. Uma edição que diz "a câmera se moveu" tende a escalar a figura no lugar.
Esboço grátis do storyboard primeiro
Antes de qualquer chamada paga, faça um esboço de cada quadro no servidor de mídia (FLUX, cerca de 8 segundos cada)
para work/keys/, depois execute stills. O usuário vê o corte inteiro de graça. Um esboço não
mantém um personagem, então diga isso quando mostrá-lo. Quadros chave pagos substituem os esboços.
Em um personagem novo, a ficha do personagem é a primeira chamada paga. Cada quadro chave então pega
essa ficha como sua primeira referência.
Mantenha uma direção de tela por personagem (espelhe um esboço se ele estiver virado para o lado errado). Personagens recorrentes são cortados de seus quadros chave reais, nunca de um esboço.
Mantenha cada personagem recorrente em assets/characters/<nome>/ com um README: a ficha, as
regras de figurino, os cenários que usam. Leia o README antes de qualquer quadro chave.
Música e som
- Faixa musical: instrumental, cerca de 30 segundos, escrita para a linha do tempo que
checkimprime. Um arco típico: um impacto no logotipo, uma faixa melancólica sob o dolly, uma construção crescente através do clipe e brilho, o impacto no fade para branco, um impacto final no card. Gere com música do ElevenLabs, ou use sua própria faixa licenciada. Salve emassets/music/<nome>.mp3e coloque o prompt emaudio.prompt. - Efeitos sonoros ficam em
assets/sfx/(impacto, whoosh, riser). Adicione entradasaudio.sfxancoradas a uma tomada. Faça um novo quando o adereço mudar. audio.mute: [<ids das tomadas>]corta a música abruptamente nessas tomadas e deixa os efeitos sonoros tocando. Use para "corte para preto, depois tiros".- Rajadas de tiros geradas se misturam em uma parede de ruído. Gere um tiro limpo e sobreponha a rajada localmente: uma prateleira baixa, um sub-thump com tom decrescente sob cada impacto, pequenas variações de tom e nível por impacto, depois um limitador.
Custos
Placas, recortes e a renderização local são grátis. Quadros chave pagos, clipes (OpenArt ou similar)
e música e efeitos sonoros do ElevenLabs custam créditos. Cote cada chamada primeiro e mantenha a
linha AUTH em ~/video-studio/relay/auth.md cobrindo-a.
job.json, resumido
length (o ponto de corte da música), product (url, título, preço, tamanhos, cores), plate
(src, prompt), figures (nome para src, opcional feet, centre_on), shots (uma lista
de id, kind, dur, panel e chaves específicas do tipo), vhs, handheld,
audio (music, prompt, music_gain, fade_out, mute, sfx), post (texto para cada
plataforma) e um look opcional. Os padrões por tipo ficam em SHOT_DEFAULTS em sr_lib.py.
O texto na tela aceita {title}, {details} e {site}.
Pegadinhas
- O rembg é necessário para recortes:
pip install rembg. O comandocutoutsdiz o que está faltando e como configurá-lo. - O brilho encontra um orbe magenta pela cor. Para outro adereço, defina
light.at([x, y, r], frações da caixa da figura) elight.rgb. Verifique preço e tamanhos com a página ao vivo. - O ffmpeg deve estar no seu PATH. Todo texto na tela é desenhado com Pillow, então o ffmpeg não precisa do filtro drawtext.