Processador de Vídeo e Gerador de Imagens para Redes Sociais

Processador de Vídeo

Processa arquivos de vídeo para criação de conteúdo no YouTube e gera gráficos para redes sociais. Esta skill oferece quatro capacidades principais:

1. Transcrição e Capítulos: Converte clipes de vídeo em transcrições com carimbo de tempo, legendas SRT e capítulos do YouTube gerados por IA.
2. Geração de Miniaturas para YouTube: Cria miniaturas para YouTube com referências de rosto e correspondência de estilo.
3. Imagens para Posts no LinkedIn: Gera infográficos profissionais e imagens para posts no LinkedIn.
4. Geração Genérica de Imagens: Cria imagens personalizadas para qualquer plataforma com dimensões e prompts flexíveis.

Quando Usar Esta Skill

Use esta skill quando o usuário:

• Quiser transcrever arquivos de vídeo ou clipes
• Precisar gerar capítulos para YouTube
• Quiser regenerar capítulos a partir de transcrições existentes
• Quiser criar miniaturas para YouTube
• Quiser criar imagens ou infográficos para posts no LinkedIn
• Quiser gerar imagens para outras plataformas (Instagram, Twitter, Facebook, etc.)
• Mencionar troca de rosto em miniaturas
• Perguntar sobre como fornecer referências de rosto ou estilo para gráficos

Escolhendo a Ferramenta de Geração de Imagem Correta

A skill fornece três scripts de geração de imagem. Escolha com base na plataforma e nos requisitos:

Use thumbnail.py (miniaturas do YouTube) quando:

• O usuário mencionar "YouTube", "miniatura" ou "thumbnail de vídeo"
• Proporção 16:9 solicitada
• Estilo dramático, chamativo e com rostos desejados
• Padrão: 1920x1080

Use linkedin-post.py (infográficos do LinkedIn) quando:

• O usuário mencionar "LinkedIn", "post do LinkedIn" ou "infográfico corporativo"
• Infográfico em formato quadrado solicitado
• Tema escuro profissional, sem rostos
• Padrão: 1200x1200

Use image-gen.py (genérico) quando:

• Dimensões personalizadas especificadas (Instagram, Twitter, Facebook, etc.)
• A plataforma não é YouTube ou LinkedIn
• O usuário solicitar explicitamente uma ferramenta flexível/personalizada
• O usuário fornecer um prompt completo com requisitos específicos de estilo
• Parâmetro obrigatório: --dimensions LARGURAxALTURA

Prioridade: Sempre prefira thumbnail.py ou linkedin-post.py quando o caso de uso corresponder. Use image-gen.py como fallback para outras plataformas ou requisitos personalizados.

Instalação e Requisitos

O processador de vídeo está localizado em video-processor/ no repositório do projeto.

Requisitos:

• Python 3.9+
• Gerenciador de pacotes uv
• FFmpeg (para transcrição)
• Chave da API OpenAI (para transcrição Whisper)
• Chave da API Gemini (para capítulos e miniaturas)
• Token da API Replicate (opcional, para troca de rosto)

Configuração do Ambiente:

cd video-processor
uv sync
# Certifique-se de que o arquivo .env existe com as chaves de API necessárias

1. Transcrição de Vídeo e Capítulos

Comando Básico de Transcrição

Transcreva clipes de vídeo e gere transcrição, legendas e capítulos:

cd video-processor
uv run transcribe.py <caminho_da_pasta>

Exemplo:

uv run transcribe.py ./meu-video-youtube/

Formato de Entrada

Os vídeos devem estar em uma pasta com prefixos numéricos para ordenação:

meu-video-youtube/
├── 1.mp4          # Introdução
├── 2.mp4          # Conteúdo principal
├── 3.mov          # Demonstração
└── 4.mp4          # Encerramento

Formatos suportados: MP4, MOV, MKV, AVI, WEBM, M4V

Arquivos de Saída

O script gera três arquivos na mesma pasta:

1. transcript.md - Markdown com carimbos de tempo

   # Transcrição
   
   [00:00] Bem-vindo de volta ao canal...
   [00:15] Hoje vamos falar sobre...
   

2. transcript.srt - Legendas SRT para editores de vídeo/YouTube

   1
   00:00:00,000 --> 00:00:15,500
   Bem-vindo de volta ao canal...
   

3. chapters.txt - Sugestões de capítulos para YouTube (geradas por IA)

   0:00 Introdução
   2:30 Configuração
   5:45 Tutorial Principal
   

Funcionalidades

• Suporte a múltiplos clipes: Processa clipes numerados com cálculo automático de deslocamento de carimbo de tempo
• Suporte a vídeos longos: Divide automaticamente vídeos com mais de 20 minutos (limite da API)
• Transcrição com carimbo de tempo: Formato Markdown com carimbos de tempo precisos
• Capítulos por IA: Gemini gera marcadores de capítulo contextuais

Regenerar Apenas Capítulos

Se você já possui uma transcrição e deseja regenerar os capítulos:

cd video-processor
uv run chapters.py <transcript.md ou caminho_da_pasta>

Exemplos:

# Aponte diretamente para o arquivo de transcrição
uv run chapters.py ./meu-video/transcript.md

# Ou aponte para a pasta que contém transcript.md
uv run chapters.py ./meu-video/

Casos de uso:

• Ajustar capítulos sem re-transcrição
• Regenerar após editar a transcrição
• Usar um modelo Gemini diferente

Notas Importantes

• Os clipes devem estar em uma pasta plana (sem subdiretórios)
• Os vídeos são processados em ordem numérica pelo prefixo do nome do arquivo
• Custo estimado: ~$0,006 por minuto de áudio (API Whisper)
• Vídeos longos são divididos automaticamente para lidar com limites da API
• Conexão com a internet necessária

2. Geração de Miniaturas

Comando Básico de Miniatura

Gere miniaturas para YouTube com tecnologia de IA:

cd video-processor
uv run thumbnail.py "sua ideia de miniatura aqui"

Comportamento padrão:

• Gera 3 variações
• Salva em: ./output/Thumbnails/[YYYY-MM-DD]/
• Usa assets/face.jpg se existir
• Saída: arquivos PNG 1920x1080
• Diretrizes da Marca: Consulte references/brand-guidelines.md para paleta de cores, composição e melhores práticas de estilo

Parâmetros da Miniatura

Obrigatórios

• ideia (posicional): Seu conceito/ideia para a miniatura

Opções de Referência de Rosto

• --face CAMINHO: Especifica uma imagem de referência de rosto (padrão: assets/face.jpg)
• --no-face: Não incluir nenhuma referência de rosto
• --face-swap: Pós-processamento com Replicate para trocar pelo rosto real (requer REPLICATE_API_TOKEN)

Estilo e Referências

• --style CAMINHO: Imagem de referência de estilo - a IA corresponde ao layout e estética
• --ref CAMINHO: Imagem de referência adicional (pode ser usado várias vezes)

Logotipo e Saída

• --logo CAMINHO: Logotipo para sobrepor na miniatura
• --logo-position [bottom-right|bottom-left|top-right|top-left]: Posição do logotipo (padrão: bottom-right)
• -o, --output CAMINHO: Diretório ou caminho do arquivo de saída
• --variations N: Número de variações a gerar (padrão: 3)

Exemplos de Miniatura

Básico - 3 variações com configurações padrão:

uv run thumbnail.py "reação chocada a demissões em massa no Google"

Com referência de estilo:

uv run thumbnail.py "minha nova ideia de vídeo" --style ./miniatura-existente.jpg --face ./eu.jpg

Com troca de rosto para semelhança exata:

uv run thumbnail.py "animado com novo recurso de IA" --face ./eu.jpg --face-swap

Variação única para teste rápido:

uv run thumbnail.py "ideia de teste rápido" --variations 1

Diretório de saída personalizado:

uv run thumbnail.py "meu conceito de vídeo" -o ./pasta-personalizada/

Sem rosto (apenas cena):

uv run thumbnail.py "código dramático na tela com erro" --no-face

Com sobreposição de logotipo:

uv run thumbnail.py "meu conceito de vídeo" --logo ./assets/logo.png

Configuração de Referência de Rosto

Para miniaturas consistentes:

1. Adicione suas fotos à pasta assets/:

   video-processor/assets/
   ├── face.jpg           # Rosto padrão (carregado automaticamente)
   ├── face-excited.jpg   # Expressões alternativas
   ├── face-shocked.jpg
   └── logo.png           # Logotipo do canal
   

2. O script usa automaticamente assets/face.jpg se existir

3. Substitua com --face para diferentes expressões

4. Use --no-face para pular a referência de rosto completamente

Referências de Estilo

O sinalizador --style corresponde à estética de miniaturas existentes:

• Layout geral e composição
• Esquemas de cores e clima
• Estilo do texto (peso da fonte, cores, posicionamento)
• Estilo de fundo e efeitos

Perfeito para manter uma identidade de canal consistente.

Diretrizes da Marca e Melhores Práticas

IMPORTANTE: Antes de gerar miniaturas, leia references/brand-guidelines.md para:

• Uso da cor azul da marca (como destaque, não dominante)
• Requisitos de tom de pele natural (sem tom azulado no rosto)
• Paletas de cores equilibradas (mistura de cores vibrantes)
• Padrões de destaque de texto (1-2 palavras-chave em azul)
• Diretrizes de composição (layout, fluxo visual)
• Exemplos comprovados de miniaturas anteriores de sucesso

Essas diretrizes garantem que as miniaturas mantenham a consistência da marca, evitando armadilhas comuns como supersaturação ou iluminação não natural.

Troca de Rosto para Semelhança Exata

Rostos gerados por IA podem não ser exatos. Use --face-swap para pós-processamento:

uv run thumbnail.py "minha ideia de vídeo" --face ./eu.jpg --face-swap

Como funciona:

1. Gera a miniatura com IA (usando o rosto como referência para posicionamento)
2. Pós-processa com Replicate para trocar pelo seu rosto real

Configuração:

• Obtenha o token da API Replicate em https://replicate.com/account/api-tokens
• Adicione ao .env: REPLICATE_API_TOKEN=r8_seu_token_aqui
• Custo: ~$0,003 por troca de rosto (~370 trocas por $1)

Especificações da Miniatura

Elemento	Valor
Resolução	1920x1080 (1080p)
Proporção	16:9
Formato	PNG (ou JPG com --output .jpg)
Variações Padrão	3
Modelo	Gemini 3 Pro (Nano Banana Pro) por padrão

Notas Importantes sobre Miniaturas

• O modelo Gemini suporta imagens de referência; Imagen não
• Custo: ~$0,13 por imagem com Gemini 3 Pro
• A troca de rosto adiciona ~$0,003 por miniatura
• 3 miniaturas com troca de rosto: ~$0,40 total
• Conexão com a internet necessária

3. Geração de Imagens para LinkedIn

Comando Básico de Imagem para LinkedIn

Gere imagens e infográficos para posts no LinkedIn com tecnologia de IA:

cd video-processor
uv run linkedin-post.py "seu conceito de post aqui"

Comportamento padrão:

• Gera 3 variações
• Salva em: ./output/LinkedIn/[YYYY-MM-DD]/
• Saída: arquivos PNG 1200x1200 (formato quadrado do LinkedIn)
• Otimizado para layouts de infográfico (sem rostos, fundo branco, design plano)

Parâmetros da Imagem para LinkedIn

Obrigatórios

• ideia (posicional): Seu conceito/ideia para o post do LinkedIn

Estilo e Referências

• --style CAMINHO: Imagem de referência de estilo - a IA corresponde ao layout e estética
• --ref CAMINHO: Imagem de referência adicional (pode ser usado várias vezes)

Logotipo e Saída

• --logo CAMINHO: Logotipo para sobrepor na imagem
• --logo-position [bottom-right|bottom-left|top-right|top-left]: Posição do logotipo (padrão: bottom-right)
• -o, --output CAMINHO: Diretório ou caminho do arquivo de saída
• --variations N: Número de variações a gerar (padrão: 3)

Exemplos de Imagem para LinkedIn

Básico - 3 variações:

uv run linkedin-post.py "Pirâmide de Validação de IA com 5 camadas mostrando responsabilidades humanas vs agente"

Com referência de estilo:

uv run linkedin-post.py "meu conceito de infográfico" --style ./infografico-existente.jpg

Variação única para teste:

uv run linkedin-post.py "teste rápido" --variations 1

Diretório de saída personalizado:

uv run linkedin-post.py "meu conceito" -o ./pasta-personalizada/

Com sobreposição de logotipo:

uv run linkedin-post.py "meu infográfico" --logo ./assets/logo.png

Especificações da Imagem para LinkedIn

Elemento	Valor
Resolução	1200x1200 (quadrado LinkedIn)
Proporção	1:1
Formato	PNG (ou JPG com --output .jpg)
Variações Padrão	3
Modelo	Gemini 3 Pro (Nano Banana Pro) por padrão
Estilo	Infográfico profissional, sem rostos, design plano

Notas Importantes sobre Imagens para LinkedIn

• Otimizado para infográficos corporativos profissionais
• Tema escuro com estética moderna e elegante
• NENHUM rosto ou pessoa incluído (estilo puro diagrama/infográfico)
• Tema de cor azul com gradientes
• Maior densidade de informação do que miniaturas do YouTube
• Custo: ~$0,13 por imagem com Gemini 3 Pro
• Conexão com a internet necessária

4. Geração Genérica de Imagens

Comando Básico de Imagem Genérica

Gere imagens com tecnologia de IA com dimensões personalizadas para qualquer plataforma:

cd video-processor
uv run image-gen.py "seu conceito de imagem" --dimensions LARGURAxALTURA

Principais funcionalidades:

• Dimensões personalizadas (parâmetro obrigatório)
• Encapsulamento mínimo do prompt (máxima flexibilidade)
• Suporta referências de estilo
• Salva em: ./output/Images/[YYYY-MM-DD]/
• Padrão: 3 variações

Parâmetros da Imagem Genérica

Obrigatórios

• ideia (posicional): Seu conceito de imagem com detalhes completos do prompt
• --dimensions LARGURAxALTURA: Dimensões da imagem (ex.: 1080x1080, 1200x675)

Estilo e Referências

• --style CAMINHO: Imagem de referência de estilo - a IA corresponde à estética
• --ref CAMINHO: Imagem de referência adicional (pode ser usado várias vezes)

Logotipo e Saída

• --logo CAMINHO: Logotipo para sobrepor na imagem
• --logo-position [bottom-right|bottom-left|top-right|top-left]: Posição do logotipo (padrão: bottom-right)
• -o, --output CAMINHO: Diretório ou caminho do arquivo de saída
• --variations N: Número de variações a gerar (padrão: 3)

Exemplos de Imagem Genérica

Post quadrado do Instagram:

uv run image-gen.py "foto de produto minimalista em fundo branco" --dimensions 1080x1080

Story do Instagram:

uv run image-gen.py "design de citação motivacional vertical" --dimensions 1080x1920

Imagem de post do Twitter:

uv run image-gen.py "gráfico de anúncio de tecnologia com tema azul" --dimensions 1200x675

Foto de capa do Facebook:

uv run image-gen.py "cabeçalho corporativo profissional" --dimensions 820x312

Com referência de estilo:

uv run image-gen.py "meu conceito" --dimensions 1200x1200 --style ./referencia.jpg

Referência de Dimensões Comuns

Plataforma	Tamanho	Proporção	Comando
Miniatura YouTube	1920x1080	16:9	Use thumbnail.py
Quadrado LinkedIn	1200x1200	1:1	Use linkedin-post.py
Quadrado Instagram	1080x1080	1:1	--dimensions 1080x1080
Story Instagram	1080x1920	9:16	--dimensions 1080x1920
Post Twitter	1200x675	16:9	--dimensions 1200x675
Post Facebook	1200x630	1.91:1	--dimensions 1200x630
Pin Pinterest	1000x1500	2:3	--dimensions 1000x1500

Notas Importantes sobre Imagens Genéricas

• --dimensions é OBRIGATÓRIO (diferente de thumbnail.py e linkedin-post.py)
• O prompt é passado praticamente sem alterações para a IA
• Use referências de estilo para garantir consistência visual
• Perfeito para qualquer plataforma não coberta pelos scripts especializados
• Custo: ~$0,13 por imagem com Gemini 3 Pro
• Conexão com a internet necessária