NovitàCome scopriamo un venditore che offre il modello sbagliato, e ti rimborsiamo se succede.
UberLLM

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 id del lavoro, un poll_url e estimated_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": true per 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.

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