Vídeos realistas com IA da Voltec com a personagem da marca

Vídeos realistas com IA da Voltec com a personagem da marca (ElevenLabs + HyperFrames)

Produção e edição de qualquer vídeo realista com IA da Voltec estrelado pela personagem da marca (Reels, Stories ou anúncio 9:16, em qualquer campanha, estação, tema ou cenário): persona de IA em lugar real → snapshot aprovado → Veo 3.1 image-to-video → narração com voz clonada → edição HyperFrames com legendas, CTA e QR. Aqui ficam o fluxo, as regras, os fixos da Voltec e os slots que mudam a cada vídeo. Corpos JSON, prompts completos e comandos longos estão em references/.

Caso de referência testado: o Reels "Verão Conectado" (15/10/2026; 20,5 s, 1080x1920, 24 fps; entregue na v5). Os valores dele aparecem como "ex.: Verão Conectado" e nunca são padrão: o que é da campanha é slot (§1b), e o exemplo preenchido está no §7.2.

• [Voltec] marca o que é fixo da Voltec com a personagem ou da área atendida (Grussaí e região). "Ex.: Verão Conectado" marca valor só da campanha de referência. O resto vale para qualquer anúncio com IA.
• Nível de evidência, o mesmo das references: [vivido] aconteceu na sessão e foi conferido; [aplicado] veio da pesquisa ou das críticas e entrou nos takes aprovados; [pesquisa] só da pesquisa; [não testado] derivado das regras, sem nenhuma geração (§8).
• $SKILL = pasta deste SKILL.md; $PROJ = pasta do projeto do vídeo. Variáveis de shell não passam de uma chamada do Bash para outra: repita o preâmbulo da seção 5 em cada chamada.
• Prompts de geração em inglês. Textos ao cliente, narração e legendas em português.
• A chave da API fica em ~/.config/elevenlabs/env (chmod 600) e scripts/el.py a lê sem imprimir. Nunca use echo, cat, env, curl -v ou set -x com ela, nem a escreva em arquivo, prompt ou mensagem.
• Você não ouve áudio: confira com STT (texto e audio_event), espectrograma do trecho e ebur128, e liste na página do portão os instantes para o cliente ouvir.

1. Quando usar

• [Voltec] Qualquer vídeo realista com IA da Voltec estrelado pela personagem da marca, que precisa parecer filmada de verdade por alguém: Reels, Stories ou anúncio; qualquer campanha, estação ou tema (promoção sazonal, institucional, dica de Wi-Fi, suporte, inauguração, Black Friday); cenário real da área atendida (Grussaí, Atafona, Chapéu do Sol, São João da Barra; o que serve de cenário: §7.1) ou interno (casa, loja, carro). Cenário, roupa ou formato que nunca foi gerado: §8.
• Geração pela API da ElevenLabs: imagem (snapshot), vídeo (Veo 3.1; Seedance pela API só com liberação, ou manual no app), narração com voz clonada, SFX e STT.
• Edição no HyperFrames: cortes por quadro, mixagem, cartões, legendas sincronizadas, CTA e QR.
• Ajuste num vídeo de IA já entregue: recortar take, trocar variação, trocar uma frase ou o CTA, versão com legendas, refinar a identidade.
• Com ela falando para a câmera ("com ela falando", "ela fala", "ela explicando"): modo falando, em references/modo-falando.md. O Veo 3.1 gera o take com a fala e o sts.py troca a voz para a Radassa. [vivido: teste de 13 s aprovado em 15/10/2026]
• [GERAL] Outra marca ou persona: o que não é [Voltec] serve, com adaptação (troque o §7.1 e preencha os slots do §1b). Projeto de referência: /home/syllas/hyperframes/voltec-reels-ia/ (Verão Conectado; só leitura).
• Não serve para motion graphics sem pessoa nem cena gerada (aí basta o HyperFrames) nem para assuntos da Voltec sem vídeo (rede, GenieACS, TR-069).

Padrão de qualidade (exigência da Voltec; use como padrão em todo projeto): realismo máximo; câmera crível, como alguém filmando de verdade; ambiente real, sem troca brusca; nenhuma anomalia no objeto da mão; locais reais com fotos licenciadas (ou do próprio cliente) mostradas ao cliente; snapshot aprovado antes de qualquer vídeo; prompts detalhados (movimento, pele, captação de áudio com ruídos reais); pesquisa de boas práticas antes de gerar.

1b. Começo rápido: qualquer vídeo novo da Voltec com a personagem

1. Leia nesta ordem: este SKILL.md (com o §7) → persona-e-marca-voltec.md §1–4 e §6–7 → o cenário: em Grussaí, locais-grussai.md §1, §3 (com a tabela "Outras estações") e §4; em outro lugar ou cena interna, o §8 deste arquivo, persona-e-marca-voltec.md §10 e locais-grussai.md §7–§10 → prompts-principios.md §1 (com o "Checklist do prompt") → só o molde de prompts-moldes.md §2 mais perto da cena (2.1 amiga filmando, 2.2 pose no mesmo lugar, 2.3 selfie, 2.5–2.6 vídeo; cena nova: 2.9–2.10). O resto, só na fase em que precisar. prompts-moldes.md e persona-e-marca-voltec.md passam do limite de uma leitura do Read: ache a seção com Grep (ex.: ^### 2\.9, ^## 10) e leia com offset/limit.
2. Já decidido (fixos da Voltec; não pergunte de novo): persona da conta, com os assets na7keiYvPpGArmyghOpk, pUgU1HXgmdqXfP02iR8T e ZY1iDcJLhPFklahPnvkM já na conta (não suba de novo; persona §4) e as âncoras de rosto, pele e mãos (persona §3.1–3.3); voz "Radassa 100%" 4yvYc2GSakxLWMhlsd6b, eleven_v4, 0.45/0.85, "pt", e o A/B agora é entre 2 seeds dessa voz; pronúncia vol-TÉC ("Voltéc" no TTS, "Voltec" na tela); sem joias nem tatuagens; sem música; logo, cores, fontes e cidades (§7.1); as regras de realismo, prompt e QA (§3, qa-checklist.md) e os portões (§2). Modelo: Veo 3.1 pela API, escolhido em 15/10/2026; só volte à pergunta se o teste de acesso sem custo (modelos-e-custos.md §2.2) ou a revisão de catálogo da Fase 1 mudarem o quadro.
3. Slots do vídeo: pergunte sempre, antes de escrever a narração (no chat basta). Exemplo preenchido no §7.2.
   • Vêm do cliente (nunca invente): tema e formato (Reels, Stories, anúncio); narração em off (padrão) ou ela falando para a câmera (references/modo-falando.md), e nesse caso a fala de cada take; oferta, preço, condições e período; anúncio pago (botão "Saiba mais" + QR) ou post orgânico ("link na bio"); destino do QR (o page_id=674 é a página "Verão Conectado 2026": não o reaproveite sem o cliente confirmar); se os créditos das fotos CC BY vão na legenda do post.
   • Pergunte e proponha (o cliente aprova no portão 1 ou 2): cenário, horário e luz; duração; roteiro de takes (por take: lugar, objeto na mão e som ambiente); roupa; gancho; cartão da campanha; texto da cama de SFX.
4. Refaça por cena, estação ou cenário (nada disso se copia do exemplo): âncora de roupa no estilo da persona §3.4 (opaca, sem estampa nem logo; tecido liso ou de trama grande, porque padrão fino tremula); luz pelo sol calculado para lugar, data e hora (locais-grussai.md §8; em Grussaí, a tabela "Outras estações" do §3: no inverno, sol a ~19,5° por volta de 15h40 e sol da tarde a ~293–304°; na selfie em contraluz ela caminha para o sul e o mar fica à direita); vento (só o do verão foi pesquisado: pesquise antes); som ambiente do lugar (no prompt de vídeo e na cama de SFX); trechos de lugar do negative_prompt (prompts-moldes.md §2.6); espaço livre no snapshot para o gancho, numa área lisa do quadro (o #q1 do template fica no alto à direita; ex.: Verão Conectado: céu aberto no T1); textos da campanha nos tokens __…__ do template: gancho, título do cartão em 1 ou 2 partes com ícone opcional (ex.: "VERÃO ☀ CONECTADO", com o sol) e oferta; texto da cama de SFX.
5. Projeto e página novos: $HOME/hyperframes/<campanha> e um Artifact novo. Não republique na URL do Verão Conectado (§7.2).

2. Fluxo em fases e portões

Cada portão é uma página (Artifact) com A/B lado a lado e perguntas numeradas. Peça resposta curta no formato "T1-A, T2-A, T3-A, voz A, modelo 1"; foi o que acelerou as decisões.

• Página: uma por projeto, republicada a cada portão (mesmo arquivo, mesma URL), com o portão atual no topo e as decisões já tomadas embaixo; campanha nova = página nova. Mídia vai como arquivos de suporte em media/: snapshots em JPG (~200 KB cada na sessão), narração em MP3 e prévia do vídeo em MP4 com poster JPG (~11 MB na sessão; limite de 15 MB por arquivo). Estrutura modelo (ex.: a página do Verão Conectado): leia https://claude.ai/artifact/MivTjGgrZ9ZyhZTftP66kh (Artifact, action: "read"). Por take: A/B, câmera, ação, som captado, narração, texto na tela e tempo. Depois: narração A/B com tabela de tempos, caminhos de modelo, locais com crédito e uma caixa com o formato de resposta.
• Registro: anote as respostas de cada portão em $PROJ/DECISOES.md e na seção "Decisões" da página.
• Juntar portões: junte 1, 2 e 3 numa página só quando oferta, CTA (pago × orgânico) e destino do QR já estiverem respondidos. Sem isso, faça antes o portão 1 (no chat basta) e não gere snapshot nem narração. A narração mostrada num storyboard antes das respostas é provisória: depois delas (pronúncia, CTA, oferta), gere a narração final com a voz escolhida (2 seeds, ~300 créditos cada), antes dos vídeos. Ex.: Verão Conectado: narracao_radassa100 no storyboard e narracao_v2_A_s1 depois das respostas.
• Nunca se junta: vídeo antes do OK do portão 3.

Fase 1. Pesquisa e plano (0 crédito)

• Pesquise em paralelo (4 frentes: modelos, realismo/anti-alucinação, locais e API; com subagentes em paralelo, se houver). Depois escreva o roteiro e o plano de takes no formato do storyboard: por take, lugar e hora, quem filma e câmera, ação em 2–3 tempos, objeto, som captado, frase da narração, texto na tela e tempo.
• Rode 2 críticas independentes antes de gastar: um subagente por foco; sem subagentes, uma passada separada por foco. Técnica = campos e limites da API (api-elevenlabs.md §3.3), duração/1080p, custos e moderação (prompts-principios.md §4). Realismo = "Checklist do prompt" de prompts-principios.md §1 + luz e geometria (sol calculado em locais-grussai.md §8; cena interna ou noturna: §8 deste arquivo). Cada uma devolve problema, take, severidade e correção.
• Rankings mudam rápido: se modelos-e-custos.md tiver mais de ~2 meses, consulte de novo. A partir de 17/11/2026, confira se veo-3.1-generate-001 ainda existe. Teste o acesso a cada modelo sem gastar (§2.2 do mesmo arquivo).
• Cliente já atendido: as references são a pesquisa. Refaça só o item acima e o que é novo na campanha: estação (o vento fora do verão não foi pesquisado), cenário fora do exemplo ou sem foto aberta (peça fotos ao cliente, locais-grussai.md §7; o que não foi pesquisado está no §8 e em locais-grussai.md §10), roupa e objeto na mão (persona §3.4). Mantenha as 2 críticas antes de gastar.
• Portão 1, o cliente recebe: modelo recomendado com placar datado e custo previsto; roteiro com a narração escrita; perguntas numeradas: CTA de anúncio pago ou de post orgânico, destino do QR, pronúncia da marca, oferta e preço (vêm do cliente; nunca invente), persona e refs (avise se alguma ref tiver outro rosto), voz e consentimento, música (padrão: sem), duração, tatuagens e joias, rótulo "Informações de IA", crédito das fotos. [Voltec] Pergunte só o que a seção 1b manda.

Fase 2. Locais reais (0 crédito)

• Fotos com a licença lida na página da foto e o local provado (geotag, OpenStreetMap): método em locais-grussai.md §7. Calcule o sol para a hora da cena (locais-grussai.md §8) e confira o vento do lugar. Só CC0 e CC BY vão para a API; foto NC serve só de referência para escrever o prompt. Cena interna (casa, loja, carro): fotos do próprio cliente, sem placa nem letreiro legível (§8).
• Portão 2, o cliente recebe: folha de contato (verde = pode ir para a API; vermelho = NC), créditos, o cenário único proposto (um lugar e um horário; ex.: Verão Conectado: a varanda e a areia em frente, numa tarde de verão) e o horário da luz.

Fase 3. Snapshots e narração (portão obrigatório)

• Snapshot = 1º quadro de cada take, no gpt-image-2.5-sunburst (9:16, 2K, high), com 2 variações por take. Revise todos com qa-checklist.md §A.
• Gere T1 A/B primeiro. Escolha você a melhor pelo qa-checklist.md §A e use-a como base: o take seguinte no mesmo lugar é edição dela, com a câmera no mesmo ponto; lugar novo é imagem nova com ela como Image 1 (ex.: Verão Conectado: T2 e T3 saíram do T1-A 5vBTv3B9FOt44Vu8jMY4 antes do storyboard). No portão 3, diga quais takes derivam do T1-X. Se o cliente escolher o outro T1, refaça os derivados a partir dele (2 imagens por take; ex.: Verão Conectado: T2 e T3, 4 imagens, ≈2,2 mil créditos) antes de qualquer vídeo.
• Narração inteira numa request, com 2 vozes ou 2 seeds. A duração medida pelo alignment define os cortes. Confira a tônica da marca e o texto falado (stress.py + STT).
• Portão 3, o cliente recebe: A/B de cada take lado a lado com a ref do rosto, players da narração A/B, as fotos dos locais e a pergunta do modelo. Pare até a resposta e guarde os generation_id aprovados.

Fase 4. Vídeos, 2 variações por take

• Veo 3.1, start_frame = generation_id do snapshot aprovado, 9:16, 1080p, 8 s, com áudio, seeds 20260115 e 20260116. O prompt descreve só movimento, câmera e som (prompts-moldes.md §2.5–2.6). A personagem não fala, exceto no modo falando (references/modo-falando.md §4).
• 19.391 créditos por geração, 2 por take (ex.: Verão Conectado, 3 takes × 2 variações = 116.346). Na sessão, 6 gerações em paralelo ficaram prontas em ~3 min (varia). O cliente não recebe nada nesta fase.

Fase 5. Seleção e QA de cada variação (portão interno)

• Folha de contato a 2 fps, tiras numeradas a 24 fps (boca) e a 8 fps (mãos e objeto), e STT do áudio nativo (qa-checklist.md §B). Anote o quadro de cada defeito (take Veo = 192 quadros; quadro = segundos × 24) e escolha in/out que o evite. Se a variação A não tem janela limpa, use a B. Se as duas falham, regere mudando UMA variável.
• Regerar além das 2 variações: dentro da reserva de 1 rodada aprovada no portão 1; acima disso, peça OK com o motivo e o custo (19.391 por take).
• O cliente só recebe algo aqui se houver dúvida real: as 2 variações em loop na página.

Fase 6. Edição (0 crédito, fora a cama de SFX)

• Cortes por take (sem transição), mixagem da narração sobre o áudio nativo (evite eco), legendas sincronizadas (30–50 caracteres, topo ou base, sem atrapalhar o rosto), CTA

... (continuação omitida para brevidade)

7. Fixos da Voltec e da área atendida

§7.1 Fixos da Voltec e da área

• Logo da Voltec: #logo-voltec, aplicado no canto superior esquerdo em cards e no final do vídeo (nos últimos 1–2 segundos, centralizado com fundo escuro, animado ou estático).
• Cores da Voltec: #0A2B5C (azul-marinho), #0099FF (azul-claro), #FFFFFF (branco). Para texto, use azul-marinho em fundo claro e branco em fundo escuro.
• Fontes: Open Sans (bold para títulos) e Inter (regular para legendas).
• Cidades da área atendida: Grussaí, Atafona, Chapéu do Sol, São João da Barra, Lagoa de Grussaí, Parque Ilha Bela, Bela Vista, São Francisco.
• Personagem da marca: descrita em persona-e-marca-voltec.md; sempre usar as âncoras de rosto, pele e mãos.
• Narração: Voz Radassa 100% (eleven_v4), com entonação natural, velocidade 0.85, estabilidade 0.45.

§7.2 Exemplo preenchido (Verão Conectado)

• Campanha: Verão Conectado
• Formato: Reels (9:16)
• Duração: 20,5 segundos
• Takes: 3
  • T1: Varanda do quiosque (Grussaí), personagem sorrindo, segurando um celular, vento suave, 3 segundos
  • T2: Areia da praia (Grussaí), personagem caminhando, mar ao fundo, 5 segundos
  • T3: Close no celular com tela ligada (personagem fora do quadro), 3 segundos
• Narração em off: "Você merece o melhor verão. Com a Voltec, internet rápida e estável onde você estiver. Grussaí, Atafona, Chapéu do Sol, São João da Barra. Aproveite. Verão Conectado: imperdível."
• CTA: "Saiba mais" + QR (âncora: link na bio)
• Oferta: 50% de desconto no primeiro mês, período: até 31 de dezembro de 2026
• Cenário: varanda do quiosque na areia, tarde de verão, luz do sol a ~30° de inclinação
• Roupa: vestido leve azul-marinho, sem estampa
• Cartão: "VERÃO ☀ CONECTADO" (título), "50% OFF no 1º mês" (subtítulo), em azul-marinho e branco
• SFX: ondas do mar, vento suave (cama)

8. Cenas e variações não testadas

Qualquer cenário, roupa, horário ou clima que não foi gerado antes (fora do caso de referência) deve ser marcado como [não testado] até ser verificado. Isso inclui:

• Cenas internas (casa, loja, carro) sem foto de referência do cliente
• Cenas noturnas ou com iluminação artificial
• Roupas com estampa, logo ou transparente
• Objetos não listados na persona (balões, guarda-chuva, animais)
• Clima chuvoso, vento forte (acima do padrão do verão)
• Ângulos de câmera não mapeados (plongée, contra-plongée)
• Personagem interagindo com crianças ou mais de 1 pessoa
• Formato diferente de 9:16 (paisagem, quadrado)

Para qualquer cena não testada, a geração exige aprovação do cliente após pesquisa e crítica de realismo (Fase 1), com o alerta de que o resultado pode exigir ajustes ou não ser satisfatório.

---

Documentação da skill 'Vídeos realistas com IA da Voltec'. Revisada em 17/11/2026.