andreakeating1982/video-generation

Geração de vídeo

Crie o vídeo que o usuário pediu como um arquivo reproduzível ou link. Duas formas de fazer a imagem, frequentemente combinadas:

• Geração por modelo com media_generate_video: pessoas, produtos, lugares, trabalho de câmera cinematográfico, animação estilizada ou 3D, transformações.
• Renderização por código no sandbox: qualquer coisa que precise ser exata, como texto, logotipos, números, gráficos e interface do usuário. Os quadros são desenhados em HTML ou Python e codificados com ffmpeg.

O ffmpeg no sandbox junta, corta, legenda, mixa e exporta.

Comece aqui

1. Descubra o que o vídeo deve comunicar, para quem e onde será reproduzido. Defina a proporção de aspecto (paisagem 16:9 para YouTube e desktop, retrato 9:16 para Reels, TikTok e Shorts), a duração aproximada e quais ativos já existem (fotos, logotipos, filmagens, voz). Use o que a solicitação implica e pergunte apenas quando uma resposta faltante mudaria o resultado.
2. Escolha a rota na tabela abaixo e leia seus arquivos em um lote paralelo. Pule arquivos que a tarefa não precisa.
3. Planeje antes de gerar: uma ideia central, depois uma lista de planos ou batidas com o que acontece, a câmera, o som e a duração de cada parte.
4. Gere, inspecione, monte se necessário, entregue.

Solicitação	Leia
Motion graphics, texto cinético, vinhetas de logotipo, dados animados, animação de interface, showreels de design	workflows/motion-graphics.md, depois references/code-rendering.md para renderizações de código ou references/video-prompts.md para renderizações de modelo
Anúncios, promos de produtos, teasers de lançamento, clipes estilo UGC, ganchos para redes sociais	workflows/ads-and-promos.md e references/video-prompts.md
Curta-metragens, videoclipes, personagens recorrentes, clipes de história	workflows/stories-and-characters.md e references/video-prompts.md
Filmagens do próprio usuário: cortar, destacar, juntar, legendar, música, redimensionar	workflows/editing-footage.md e references/ffmpeg.md
Juntar clipes gerados, adicionar música ou títulos	references/ffmpeg.md

A ferramenta de vídeo

Ler esta skill desbloqueia as ferramentas de mídia. Se media_generate_video ainda estiver faltando, chame media_generate com um resumo de uma linha. O vídeo não está disponível no plano Free.

• A descrição da ferramenta lista cada modelo com suas durações, resoluções e créditos por segundo, e diz qual modelo se adequa a qual solicitação. Use o modelo que o usuário nomear; caso contrário, siga essa orientação.
• MiniMax H3 Max (o padrão) retorna o videoUrl finalizado na mesma chamada. WAN 3.0, Kling 4.0 e os modelos Seedance renderizam em segundo plano: a chamada retorna um jobId imediatamente e você é retomado automaticamente com o vídeo após alguns minutos. Nunca faça polling e nunca chame a ferramenta novamente para o mesmo clipe. Quando um plano precisar de vários clipes em segundo plano, inicie todos na mesma etapa para que você seja retomado uma vez.
• H3 Max e Seedance 2.5 podem seguir um prompt de múltiplos planos (Shot 1, Shot 2, ...) dentro de um único clipe. O WAN 3.0 renderiza uma única tomada contínua com trabalho de câmera forte.
• Cada modelo gera áudio junto com a imagem. Descreva diálogo (entre aspas), ambiente, efeitos sonoros e música no prompt.
• Modos: texto-para-vídeo; imagem-para-vídeo (keyframes.first); primeiro ao último quadro (keyframes.first + keyframes.last); imagens de referência (citadas como "Imagem 1", "Imagem 2" na ordem da lista — @Image1, @Image2 com Kling 4.0 — não combinável com keyframes.last). Um quadro inicial de imagem fornece resultados melhores e mais controláveis do que apenas texto.

Regras que decidem a qualidade

• Pessoas e produtos precisam de referências de imagem. Use as fotos do usuário ou gere uma referência com media_generate_image primeiro, depois passe-a como keyframes.first ou em references. Configurações, iluminação e estilo podem ser descritos em palavras.
• Texto exato, logotipos, preços e interface nunca são deixados para o modelo de vídeo. Ele os distorce. Renderize-os em código ou sobreponha-os com ffmpeg.
• Um clipe por solicitação sempre que couber no modelo. Divida apenas para limites reais (um anúncio de 45 segundos são vários clipes unidos com ffmpeg) ou quando o usuário quiser clipes separados.
• Escreva o prompt do modelo em inglês. Coloque falas e palavras na tela no idioma que o usuário quiser.
• Gaste deliberadamente. Para vários clipes ou renderizações longas em segundo plano, declare o plano de tomadas e os créditos totais em uma linha. Peça autorização apenas quando o total estiver muito acima do que o usuário esperaria.

Verifique e entregue

• Inspecione todo resultado antes de entregar. Use ffprobe para duração, tamanho e áudio, e uma folha de contato de quadros (veja references/ffmpeg.md) visualizada com file_view. file_view também analisa um arquivo de vídeo ou URL diretamente quando você precisa verificar movimento, fala ou som.
• Nunca gere um clipe novamente por conta própria. Todo clipe custa créditos. Se um resultado tiver uma falha real (assunto errado, identidade quebrada, texto obrigatório distorcido, uma ação faltante), mostre-o, diga em uma frase o que está errado e pergunte se deve fazer uma versão corrigida. Gere novamente sem perguntar apenas quando o usuário disser para continuar corrigindo até ficar certo.
• Renderizações de código e edições ffmpeg não custam créditos: corrija problemas reais neles você mesmo, mas pare de polir uma vez que um quadro funcione.
• Entrega: um único clipe de modelo é mostrado no chat a partir de seu videoUrl. Arquivos que você montou ou renderizou no sandbox saem com send_attachment. Em uma ou duas linhas, declare o formato, proporção de aspecto, duração e se há som.
• Para um narrador explicativo, um avatar falante ou edição de linha do tempo longa, o Video Agent, Talking Videos ou Video Editor da plataforma podem ser mais adequados. Ofereça o link quando for o caso.