Flussi di lavoro per creativi pubblicitari
Quattro ricette che trasformano una foto di prodotto in creativi pubblicitari, e lo schema che condividono. Ogni ricetta è un flusso di lavoro n8n che importi tramite link e un singolo comando di uno script senza dipendenze. Cosa ha prodotto e quanto è costato ciascuno in un'esecuzione reale si trova su la pagina dei creativi pubblicitari.
| Ricetta | Flusso di lavoro n8n (importa tramite link) | Comando script |
|---|---|---|
| Una persona che tiene in mano il prodotto (immagine fissa 9:16), una clip da quell'immagine fissa, una frase parlata | ad-ugc-still-clip-voice.json | ugc product.jpg |
| Variazioni statiche, una immagine per riga di un elenco | ad-static-variations.json | variations product.jpg |
| Un'immagine fissa e una clip per riga di un file CSV o di un Fogli Google, con una pianificazione | ad-sheet-rows-to-ads.json | sheet rows.csv |
| Un'immagine fissa da studio del solo prodotto e una clip in stile giradischi | ad-product-spin-video.json | spin product.jpg |
I file si trovano in
il repository dei template:
i flussi di lavoro in workflows/, lo script e la skill dell'agente in skills/ad-creative/.
Esegui uno
In n8n. Importa il link (⋯ → Importa da URL…), crea una credenziale Header Auth
(Nome Authorization, Valore Bearer ull_...), modifica il nodo Settings e
clicca su Execute workflow. Configurazione completa: n8n modelli video.
Come script (Node 18 o più 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
Da un agente di codifica (Claude Code e altri che leggono le skill):
npx skills add PSA-Team-source/uberllm-n8n-templates --skill ad-creative
Il modello che ogni ricetta segue
1. Crea l'immagine fissa nella forma che desideri
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 }'
La risposta contiene l'immagine a data[0].url. I modelli da immagine a video in queste ricette
creano il clip nella forma della sua prima immagine e non accettano aspect_ratio (una richiesta
che ne invia uno viene rifiutata prima di qualsiasi addebito), quindi la forma viene scelta qui: 9:16, 4:5
o 1:1.
Una richiesta di immagine risponde quando l'immagine è pronta. Può scadere con un 504, che
non viene addebitato: inviala di nuovo. Le ricette tentano fino a tre volte.
2. Conserva l'immagine fissa e passala al modello video come file
L'immagine modificata torna come un link a /v1/media/artifacts/…, che richiede la tua chiave
e dura circa 15 minuti. Scaricala subito, poi caricala e usa l'ID del file come image_url
del clip:
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
Non passare un link /v1/media/artifacts/… come image_url di un lavoro video. Un provider
non può aprire un link che richiede la tua chiave, e il lavoro fallisce (senza addebito). Un ID file o un
link /v1/files/… funziona.
3. Avvia il clip, con un limite massimo
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 }'
- La risposta arriva subito con il
iddel lavoro, unpoll_urleestimated_cost_usd. Idempotency-Key: invia di nuovo la stessa richiesta con la stessa chiave (dopo una connessione interrotta o un n8n tentativo) e riceverai lo stesso lavoro, non un secondo.models: backup, provati in ordine quando il primo non ha un provider libero.max_cost: il tuo limite massimo in dollari USA. Un lavoro che costerebbe di più viene rifiutato o annullato senza addebito. Il costo è quello addebitato dal provider, che può essere superiore al prezzo mostrato all'inizio quando un lavoro si sposta su un altro provider, quindi imposta questo per ogni lavoro.- Aggiungi
"validate": trueper controllare e prezzare la richiesta senza creare nulla.
4. Attendi: polling o callback
Polling. Chiedi a poll_url ogni 5 a 10 secondi. Risponde 202 mentre il lavoro è
queued o running, e 200 una volta terminato: succeeded, failed, canceled o
expired. Gli ultimi tre non costano nulla. Nei test un clip di 5 secondi ha impiegato tra
1.5 e 5.5 minuti, quindi concedi almeno 15 minuti prima di arrenderti; un lavoro che nessuno controlla
viene comunque completato e fatturato, o rimborsato. Tutti gli stati: Stato del lavoro.
Callback. Aggiungi "callback_url": "https://your-app.example/uberllm/jobs" alla richiesta di avvio
e UberLLM invia un POST con il JSON del lavoro quando è terminato e il suo conto
è definitivo. In n8n questo è un secondo workflow che inizia con un nodo Webhook. Controlla
l'header UberLLM-Signature prima di fidarti di un messaggio: Controlla la firma.
5. Scarica prima che il link scada
| File | Il link dura |
|---|---|
Un'immagine a /v1/media/artifacts/… |
circa 15 minuti |
| Un video | circa 3 ore dopo la fine del lavoro |
Un file che hai caricato su /v1/files |
24 ore |
Dopodiché il link risponde 404 artifact_expired. Le ricette scaricano ogni file
non appena esiste. Per far sì che un clip venga inserito direttamente nel tuo storage, aggiungi
output_upload_url (un link PUT pre-firmato) alla richiesta di avvio:
Invia i risultati al tuo storage.
6. Voce, sottotitoli e l'unione
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
La risposta vocale è l'audio stesso; il suo costo è nell'header X-UberLLM-Cost-USD.
Molti annunci da un foglio
La ricetta del foglio legge un CSV con le colonne name, image_url, scene, motion e
aspect_ratio (un esempio).
Un Google Sheet funziona una volta pubblicato come CSV (File → Condividi → Pubblica sul web → CSV).
- Crea le righe che non ha creato prima, al massimo 5 per esecuzione, a meno che tu non lo modifichi.
- Una riga che fallisce non ferma le altre e viene riprovata alla prossima esecuzione.
- In n8n la memoria delle righe completate viene salvata quando il workflow è attivo e viene eseguito dalla
sua pianificazione. Un'esecuzione di test manuale non la salva. Lo script la mantiene in
done.jsonnella cartella di output, quindi funziona da cron.
Cosa non fanno queste ricette
- Unire clip, o aggiungere una traccia vocale o sottotitoli a una clip (questo è il passaggio ffmpeg).
- Avatar parlanti o sincronizzazione labiale.
- Mantenere i tuoi file: scaricali.
- Controllare il risultato. Un modello può cambiare un'etichetta, un colore o una forma, e disegna i lati che la tua foto non mostra. Guarda ogni immagine e clip prima che venga eseguita.
Prima di pubblicare annunci
- Le persone in queste immagini sono generate dall'IA. Etichettale dove la piattaforma o la tua legge locale lo richiedono, e non presentarle mai come clienti reali, testimonianze o esperti.
- Tieni le dichiarazioni sulla salute e le immagini prima/dopo fuori dai prompt e dalle voci fuori campo, e segui le regole della piattaforma pubblicitaria per la categoria del tuo prodotto.
- Ogni modello ha un creatore i cui termini stabiliscono come il suo output può essere utilizzato. Leggili per i modelli che usi, e usa solo foto di prodotti per le quali hai i diritti.
Le fonti per queste regole sono collegate su la pagina delle creatività pubblicitarie.