Fluxos de trabalho para criativos de anúncios
Quatro receitas que transformam uma foto de produto em criativos de anúncios, e o padrão que elas compartilham. Cada receita é um fluxo de trabalho n8n que você importa por link e um comando de um script sem dependências. O que cada uma produziu e custou em uma execução real está em a página de criativos de anúncios.
| Receita | Fluxo de trabalho n8n (importar por link) | Comando do script |
|---|---|---|
| Uma pessoa segurando o produto (imagem estática 9:16), um clipe dessa imagem estática, uma fala | ad-ugc-still-clip-voice.json | ugc product.jpg |
| Variações estáticas, uma imagem por linha de uma lista | ad-static-variations.json | variations product.jpg |
| Uma imagem estática e um clipe por linha de um arquivo CSV ou Google Sheet, em um agendamento | ad-sheet-rows-to-ads.json | sheet rows.csv |
| Uma imagem estática de estúdio do produto sozinho e um clipe estilo turntable | ad-product-spin-video.json | spin product.jpg |
Os arquivos estão em
o repositório de modelos:
os fluxos de trabalho em workflows/, o script e a skill do agente em skills/ad-creative/.
Rodar um
Em n8n. Importe o link (⋯ → Importar do URL…), crie uma credencial Header Auth
(Nome Authorization, Valor Bearer ull_...), edite o nó Settings e
clique em Executar fluxo de trabalho. Configuração completa: [n8n modelos de vídeo]](/docs/n8n-video).
Como um script (Node 18 ou mais recente):
export UBERLLM_API_KEY=ull_...
curl -O https://raw.githubusercontent.com/PSA-Team-source/uberllm-n8n-templates/main/skills/ad-creative/scripts/ad-creative.mjs
node ad-creative.mjs ugc product.jpg --dry-run # prices the run; makes nothing, charges nothing
node ad-creative.mjs ugc product.jpg --merge # --merge joins clip and voice with ffmpeg
De um agente de codificação (Claude Code e outros que leem habilidades):
npx skills add PSA-Team-source/uberllm-n8n-templates --skill ad-creative
O padrão que toda receita segue
1. Faça a imagem estática no formato desejado
curl https://api.uberllm.dev/v1/images/edits \
-H "Authorization: Bearer $UBERLLM_API_KEY" -H "Content-Type: application/json" \
-d '{ "model": "google/nano-banana-2-edit",
"prompt": "A hand holds this exact product in a bright kitchen, phone-camera look",
"image_url": "https://example.com/product.jpg",
"aspect_ratio": "9:16", "n": 1 }'
A resposta tem a imagem em data[0].url. Os modelos de imagem para vídeo nestas receitas criam o clipe no formato da sua primeira imagem e não aceitam aspect_ratio (uma solicitação que envia um é recusada antes de qualquer cobrança), então o formato é escolhido aqui: 9:16, 4:5 ou 1:1.
Uma solicitação de imagem responde quando a imagem está pronta. Pode expirar com um 504, que não é cobrado: envie-a novamente. As receitas tentam até três vezes.
2. Guarde a imagem estática e entregue-a ao modelo de vídeo como um arquivo
A imagem editada retorna como um link para /v1/media/artifacts/…, que precisa da sua chave e dura cerca de 15 minutos. Baixe-a imediatamente, depois faça o upload e use o id do arquivo como o image_url do clipe:
curl -o still.png -H "Authorization: Bearer $UBERLLM_API_KEY" "<data[0].url>"
curl https://api.uberllm.dev/v1/files -H "Authorization: Bearer $UBERLLM_API_KEY" -F [email protected]
# → { "id": "file_…", … } kept for 24 hours
Não passe um link /v1/media/artifacts/… como image_url de um trabalho de vídeo. Um provedor não pode abrir um link que precisa da sua chave, e o trabalho falha (sem custo). Um id de arquivo ou um link /v1/files/… funciona.
3. Inicie o clipe, com um limite máximo
curl https://api.uberllm.dev/v1/video/generations \
-H "Authorization: Bearer $UBERLLM_API_KEY" -H "Content-Type: application/json" \
-H "Idempotency-Key: ad-0042-clip" \
-d '{ "model": "kling/kling-o3-standard-image-to-video",
"models": ["fal-ai/kling-video/o3/standard/image-to-video"],
"prompt": "The hand lifts the product toward the camera and turns it a little",
"image_url": "file_…", "duration_seconds": 5, "audio": false,
"max_cost": 1.5 }'
- A resposta vem imediatamente com o
iddo trabalho, umpoll_urleestimated_cost_usd. Idempotency-Key: envie a mesma solicitação novamente com a mesma chave (após uma conexão perdida, ou uma nova tentativa n8n) e você receberá o mesmo trabalho de volta, não um segundo.models: backups, tentados em ordem quando o primeiro não tem provedor livre.max_cost: seu limite máximo em dólares americanos. Um trabalho que custaria mais é recusado ou cancelado sem custo. A conta é o que o provedor cobrou, o que pode ser acima do preço mostrado no início quando um trabalho é movido para outro provedor, então defina isso em cada trabalho.- Adicione
"validate": truepara verificar e precificar a solicitação sem criar nada.
4. Espere: faça polling ou receba um callback
Sondagem. Pergunte a poll_url a cada 5 a 10 segundos. Ele responde 202 enquanto o trabalho está queued ou running, e 200 assim que termina: succeeded, failed, canceled ou expired. Os três últimos não custam nada. Nos testes, um clipe de 5 segundos levou entre 1.5 e 5.5 minutos, então espere pelo menos 15 minutos antes de desistir; um trabalho que ninguém verifica ainda é finalizado e cobrado, ou reembolsado. Todos os status: Status do trabalho.
Callback. Adicione "callback_url": "https://your-app.example/uberllm/jobs" à solicitação inicial e o UberLLM envia um POST com o JSON do trabalho quando ele termina e sua conta é final. Em n8n, este é um segundo fluxo de trabalho que começa com um nó Webhook. Verifique o cabeçalho UberLLM-Signature antes de confiar em uma mensagem: Verifique a assinatura.
5. Baixe antes que o link expire
| Arquivo | Link dura |
|---|---|
Uma imagem em /v1/media/artifacts/… |
cerca de 15 minutos |
| Um vídeo | cerca de 3 horas após o término do trabalho |
Um arquivo que você carregou para /v1/files |
24 horas |
Depois disso, o link responde 404 artifact_expired. As receitas baixam cada arquivo assim que ele existe. Para que um clipe seja colocado diretamente no seu próprio armazenamento, adicione output_upload_url (um link PUT pré-assinado) à solicitação inicial:
Envie os resultados para o seu próprio armazenamento.
6. Voz, legendas e a junção
curl https://api.uberllm.dev/v1/audio/speech -o voice.mp3 \
-H "Authorization: Bearer $UBERLLM_API_KEY" -H "Content-Type: application/json" \
-d '{ "model": "venice/kokoro-tts", "voice": "af_heart", "response_format": "mp3",
"input": "Cold water all day, wherever the day takes you." }'
# a timed caption file from that voice track
curl https://api.uberllm.dev/v1/audio/transcriptions -o voice.srt \
-H "Authorization: Bearer $UBERLLM_API_KEY" \
-F [email protected] -F model=venice/whisper-large-v3 -F response_format=srt
# UberLLM does not join files: clip + voice is one ffmpeg command
ffmpeg -i clip.mp4 -i voice.mp3 -map 0:v:0 -map 1:a:0 -c:v copy -c:a aac -af apad -shortest ad.mp4
A resposta de fala é o próprio áudio; seu custo está no cabeçalho X-UberLLM-Cost-USD.
Vários anúncios de uma planilha
A receita da planilha lê um CSV com as colunas name, image_url, scene, motion e
aspect_ratio (um exemplo).
Uma Planilha Google funciona uma vez que é publicada como CSV (Arquivo → Compartilhar → Publicar na web → CSV).
- Ela cria as linhas que não criou antes, no máximo 5 por execução, a menos que você mude isso.
- Uma linha que falha não para as outras e é tentada novamente na próxima execução.
- Em n8n a memória das linhas concluídas é salva quando o fluxo de trabalho está ativo e é executado de acordo com sua programação. Uma execução de teste manual não a salva. O script a mantém em
done.jsonna pasta de saída, para que funcione via cron.
O que estas receitas não fazem
- Juntar clipes, ou colocar uma trilha de áudio ou legendas em um clipe (essa é a etapa do ffmpeg).
- Avatares falantes ou sincronização labial.
- Manter seus arquivos: baixe-os.
- Verifique o resultado. Um modelo pode mudar um rótulo, uma cor ou uma forma, e ele desenha os lados que sua foto não mostra. Olhe cada imagem e clipe antes de rodar.
Antes de rodar anúncios
- As pessoas nestas imagens são geradas por IA. Rotule-as onde a plataforma ou sua lei local pedir, e nunca as apresente como um cliente real, um depoimento ou um especialista.
- Mantenha alegações de saúde e imagens de antes/depois fora dos prompts e das linhas de voz, e siga as regras da plataforma de anúncios para a categoria do seu produto.
- Cada modelo tem um criador cujos termos dizem como sua saída pode ser usada. Leia-os para os modelos que você usa, e use apenas fotos de produtos para as quais você tem os direitos.
As fontes para estas regras estão linkadas na a página de criativos de anúncios.