NovoComo detectamos um vendedor que oferece o modelo errado, e reembolsamos você se isso acontecer.
UberLLM

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 id do trabalho, um poll_url e estimated_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": true para 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.

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.json na 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.