Skill de Produção de Vídeo Cinematográfico com Narrativa
Este skill guia a produção completa de vídeos cinematográficos de alta fidelidade a partir de capítulos de novelas ou roteiros narrativos. Ele combina geração multimodal de imagens com ancoragem de referência de personagens, locução pura de estúdio via Gemini TTS e direção de câmera fluida com múltiplos cortes usando HyperFrames AI (GSAP).
Filosofia Central & Padrões de Produção
- Consistência Estrita de Personagens: Cada personagem deve ser visualmente ancorado usando uma Ficha de Referência Conceitual. Nunca gere cenas da história apenas com prompts de texto cegos — sempre passe os bytes da imagem de referência do personagem e reforce o DNA visual (estrutura facial, cabelo, vestuário).
- Locução Pura de Estúdio (Gemini TTS): A voz do narrador deve ser gerada usando
gemini-3.8-flash-tts. NUNCA coloque prompts de sistema, instruções de tom ou metadados no prompt de conteúdo; passe estritamente o texto puro da narração da história, caso contrário o modelo TTS falará as instruções em voz alta. - Sem Poluição Sonora Sintética: Evite efeitos sonoros procedurais/sintéticos e música de fundo genérica, a menos que explicitamente solicitado pelo usuário. Uma narração vocal limpa e de alta clareza proporciona uma experiência imersiva de audiobook encontra filme.
- Sem Legendas: Evite queimar ou sobrepor legendas na tela cinematográfica, a menos que solicitado. Mantenha a tela limpa com uma letterbox anamórfica 2.39:1 para maximizar o impacto visual.
- Cortes Cinematográficos Dinâmicos: Evite tomadas estáticas únicas por parágrafo. Para cenas de alta intensidade ou ação, quebre o ritmo em múltiplos cortes rápidos (ex.: Corte 1: detalhe extremo/reação, Corte 2: impacto/plano geral, Corte 3: close-up emocional).
- Segurança Estrita (
.env): Nunca leia, exiba (cat), imprima, mostre ou edite.env. Scripts de back-end carregam variáveis de ambiente programaticamente na memória em tempo de execução.
Pipeline de Produção (Passo a Passo)
flowchart TD
A["Texto do Capítulo (chapter_XX.md)"] --> B["1. Decomposição em Cenas & Storyboard"]
B --> C["2. Bíblia de Personagens & Fichas de Referência"]
C --> D["3. Geração Multimodal de Imagens (gemini-2.5-flash-image)"]
B --> E["4. Locução Pura de Estúdio (gemini-3.8-flash-tts)"]
D --> F["5. Composição HyperFrames & Movimento GSAP"]
E --> F
F --> G["6. Validação (npx hyperframes lint)"]
G --> H["7. Renderização Completa (npx hyperframes render)"]
Etapa 1: Decomposição da História e Construção do Storyboard
- Leia o capítulo alvo da novela ou o texto da história (ex.:
chapter_01.md). - Divida o capítulo em 8–12 batidas/sequências cinematográficas distintas.
- Para cada sequência, especifique:
scene_id: ex.:scene_01,scene_02, etc.title: Título descritivo curto (português/inglês).narration: O texto exato e puro da narração para aquela sequência.visual_prompt: Prompt cinematográfico detalhado (16:9, iluminação, ângulo de câmera, atmosfera).characters_present: Lista de chaves dos personagens (ex.:["prima", "tawan"]).
- Salve a decomposição em
video_project/storyboard.json.
Etapa 2: Bíblia de Personagens e Ancoragem de Referência
- Verifique
character_references/character_bible.mdpara saber se existem personagens já definidos. - Se novos personagens forem introduzidos, gere primeiro uma Ficha de Referência de Personagem dedicada:
- Formato: folha de conceito em widescreen 16:9 mostrando múltiplos ângulos (close-up retrato, vista 3/4, corpo inteiro) sobre um fundo de estúdio cinematográfico neutro.
- Salve em
character_references/<chave_do_personagem>_reference_sheet.png. - Documente o DNA visual exato em
character_references/character_bible.md(idade, traços faciais, penteado, estilo de roupa, características distintivas).
Consulte o Guia de Consistência de Personagens para modelos de prompt de referência detalhados.
Etapa 3: Geração Multimodal de Imagens
- Use
gemini-2.5-flash-imageatravés do SDK Google GenAI. - Para cenas com personagens já estabelecidos:
- Carregue a ficha de referência do personagem como bytes de imagem binária.
- Forneça a parte da imagem de referência junto com o prompt de texto na requisição multimodal.
- Instrua explicitamente o modelo: "Usando o personagem exato da imagem de referência (, <descrição>): [Descrição da cena]".
- Para cenas de ação / alto drama:
- Gere sub-cortes múltiplos (ex.:
scene1_cut1_tire.png,scene1_cut2_impact.png,scene1_cut3_face.png).
- Gere sub-cortes múltiplos (ex.:
- Salve as imagens em
video_project/images/e copie-as para os assets do projeto HyperFrames (sample_hyperframe/assets/).
Script auxiliar: scripts/generate_scene_images.py
Etapa 4: Locução Pura de Estúdio (Gemini TTS)
- Use o modelo
gemini-3.8-flash-tts. - Configure a geração de áudio:
response_modalities=["AUDIO"]speech_configcom voz predefinida (ex.:PuckouAoede).
- CRÍTICO: Passe APENAS o texto exato da narração da história em
contents.# CORRETO: response = client.models.generate_content( model="gemini-3.8-flash-tts", contents=scene["narration"], # Apenas texto puro! config=types.GenerateContentConfig(response_modalities=["AUDIO"], speech_config=...) ) - Converta o PCM/WAV bruto de saída para MP3 limpo a 44,1 kHz usando FFmpeg.
- Salve os arquivos de áudio em
video_project/audio/voice/e copie parasample_hyperframe/assets/.
Script auxiliar: scripts/generate_gemini_tts.py
Etapa 5: Montagem HyperFrames e Movimento Cinematográfico
- Meça a duração de cada arquivo de voz da cena usando
ffprobe. - Calcule os tempos de início e durações das cenas:
scene_duration = voice_duration + 0.6s(0,2s de pré-rolagem + 0,4s de margem).
- Gere
sample_hyperframe/index.htmlcom:- Sobreposições de letterbox widescreen 2.39:1 (
.letterbox-top,.letterbox-bottom). - Contêineres de imagem puros, sem legendas.
- Elementos
<audio>nativos agendados em seus timestamps exatos (tl.call(() => audio.play(), ..., voice_start)). - Animação de linha do tempo GSAP:
- Cortes múltiplos para batidas de ação (alternância de exibição com transições de flash branco).
- Aproximação / panorâmica lenta estilo Ken Burns (
scale: 1.0 -> 1.08-1.12). - Crossfades / cortes suaves entre cenas.
- Registre a linha do tempo:
window.__timelines = [tl].
- Sobreposições de letterbox widescreen 2.39:1 (
- Atualize
sample_hyperframe/hyperframes.jsoncom a duração total exata:{ "duration": 177.6, "fps": 30, "width": 1920, "height": 1080 }
Script auxiliar: scripts/build_hyperframes_project.py
Guia de animação detalhada: Guia de Movimento HyperFrames
Etapa 6: Verificação e Renderização
- Verificação de Lint:
Garanta 0 erros, 0 avisos.cd sample_hyperframe npx hyperframes lint - Renderizar o Filme Completo:
npx hyperframes render --output ../video_project/output/<nome_do_capitulo>_full_movie.mp4 - Verificação de Qualidade:
- Confirme que o arquivo existe e o tamanho é razoável (~150–250 MB para ~3 min Full HD).
- Verifique a sincronização áudio-vídeo e a ausência de quadros pretos ou quedas de áudio.