produtoshotad — foto de produto → 5 anúncios + 5 vídeos, com IA

O que é

Automação de creative de anúncio com IA

Um agente Claude Code orquestra geração de imagem, animação de vídeo e voz — sem precisar de fotógrafo, editor de vídeo ou dublê de anúncio pago em cada teste.

📸 Anti-drift

Referência do produto (hero + close-up) travada e reanexada em toda geração — o produto não muda de forma/cor/proporção entre as 5 variações.

🧩 3 workers

Agnes (US$0, só imagens), HyperFrames (vídeo animando as stills, sem IA de vídeo) ou o pipeline original completo (Fal.ai/Seedance + ElevenLabs).

✅ QA obrigatório

Checkpoint humano antes de cada estágio avançar — gate que já pegou alucinações reais (embalagem fictícia, texto ilegível) durante o desenvolvimento.

Como funciona

Do photo ao anúncio pronto

Os 3 workers compartilham a mesma estrutura de entrega — 5 stills + 5 vídeos — e só divergem na ferramenta de geração.

1 foto de produto→ hero + close-up travados→ 5 stills (3 plain + 2 overlay)→ QA humano→ animação HyperFrames ou i2v Seedance→ voz (Kokoro/ElevenLabs)→ 5 vídeos 9:16

1 · Agnes

Só imagens, API Agnes AI, US$0 de custo de geração. Sem vídeo.

2 · HyperFrames

Anima as stills já aprovadas com GSAP (Ken Burns, typewriter, glass card, flash-cut) — nenhum modelo de vídeo por IA envolvido.

3 · Original

Pipeline completo com Fal.ai/Seedance para image-to-video e ElevenLabs para voz — qualidade máxima, custo pago.

Pré-requisitos

O que precisa estar no ar

Depende de qual worker você vai rodar — nenhum dos três exige todos os itens abaixo ao mesmo tempo.

Worker 1 — Agnes

Chave da API Agnes AI (US$0).

# .env
AGNES_API_KEY=...

Worker 2 — HyperFrames

CLI HyperFrames (via npx) + Kokoro TTS local, opcional.

# roda direto
npx hyperframes init

Worker 3 — Original

Chaves Fal.ai e ElevenLabs.

# .env
FAL_KEY=...
ELEVENLABS_API_KEY=...

Guia de uso · passo a passo

Rodando o worker 1 + 2 (custo zero)

O caminho mais barato: gerar as 5 stills com Agnes, depois animá-las com HyperFrames — sem nenhuma chamada de vídeo por IA.

Coloque a foto do produto

Uma foto real, fundo neutro, em products/.

cp minha-foto.png products/hero.png  # referência travada

Gere as 5 stills (worker 1, Agnes)

3 plain (uso direto) + 2 overlay (base para copy). Retry automático em 503, US$0.

python3 scripts/agnes_stills.py products/hero.png --desc "descrição em inglês" --ratio 9:16  # output/stills/*.png

QA checkpoint (obrigatório, não pule)

Confira as 5 imagens contra a foto real antes de seguir — pega alucinação de embalagem/texto fictício antes de virar vídeo.

# abra e confira cada still em output/stills/ antes do próximo passo

Gere a narração (opcional, Kokoro local)

TTS local, sem custo, reusa os pesos já baixados pelo HyperFrames.

python3 scripts/kokoro_tts.py "seu roteiro aqui" -o output/voz/ad.wav  # .wav local

Monte e renderize o vídeo (worker 2, HyperFrames)

Anima as stills com Ken Burns, legenda com palavra-chave destacada, flash-cut entre cenas e CTA final — sem gerar nenhum pixel novo por IA de vídeo.

npx hyperframes init meu-anuncio -e blank --resolution portrait --non-interactive  # scaffold
# copie scripts/hyperframes-still-scene.template.html pro index.html e ajuste
npm run check && npm run render  # MP4 final em renders/

Roadmap

Onde o projeto está

Os 3 workers estão implementados e os workers 1+2 foram testados de ponta a ponta (incluindo bugs reais encontrados e corrigidos no processo).

Feito

Workers 1 e 2 implementados e testadosStills via Agnes, vídeo via HyperFrames — testado com produção completa, 0 erros no lint, contraste WCAG AA.