NieuwZo betrappen we een verkoper die het verkeerde model aanbiedt, en krijg je je geld terug.
UberLLM

Advertentiecreatie workflows

Vier recepten die één productfoto omzetten in advertentiemateriaal, en het patroon dat ze delen. Elk recept is een n8n workflow die je importeert via een link en één commando van een script zonder afhankelijkheden. Wat elk heeft opgeleverd en gekost bij een echte uitvoering staat op de advertentiecreatiepagina.

Recept n8n workflow (importeren via link) Scriptcommando
Een persoon die het product vasthoudt (9:16 stilstaand beeld), een clip van dat stilstaande beeld, een gesproken zin ad-ugc-still-clip-voice.json ugc product.jpg
Statische variaties, één afbeelding per regel van een lijst ad-static-variations.json variations product.jpg
Eén stilstaand beeld en één clip per rij van een CSV-bestand of Google Sheet, volgens een schema ad-sheet-rows-to-ads.json sheet rows.csv
Een studiofoto van alleen het product en een clip in draaitafelstijl ad-product-spin-video.json spin product.jpg

De bestanden staan in de sjablonenrepository: workflows in workflows/, het script en de agent skill in skills/ad-creative/.

Eén keer uitvoeren

In n8n. Importeer de link (⋯ → Importeren van URL…), maak één Header Auth credential aan (Naam Authorization, Waarde Bearer ull_...), bewerk de Settings node en klik op Workflow uitvoeren. Volledige installatie: n8n video templates.

Als script (Node 18 of nieuwer):

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

Van een coding agent (Claude Code en andere die skills lezen):

npx skills add PSA-Team-source/uberllm-n8n-templates --skill ad-creative

Het patroon dat elk recept volgt

1. Maak het stilbeeld in de gewenste vorm

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 }'

Het antwoord bevat de afbeelding op data[0].url. De image-to-video modellen in deze recepten maken de clip in de vorm van de eerste afbeelding en accepteren geen aspect_ratio (een verzoek dat er een stuurt, wordt geweigerd voordat er kosten in rekening worden gebracht), dus de vorm wordt hier gekozen: 9:16, 4:5 of 1:1.

Een afbeeldingsverzoek beantwoordt wanneer de afbeelding klaar is. Het kan een time-out geven met een 504, wat niet in rekening wordt gebracht: stuur het opnieuw. De recepten proberen het tot drie keer toe.

2. Bewaar het stilbeeld en geef het als bestand door aan het videomodel

De bewerkte afbeelding komt terug als een link naar /v1/media/artifacts/…, waarvoor je API key nodig is en die ongeveer 15 minuten geldig blijft. Download deze direct, upload hem vervolgens en gebruik de file id als de image_url van de 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

Geef geen /v1/media/artifacts/… link door als image_url van een videotask. Een provider kan een link die je API key nodig heeft niet openen, en de task mislukt (zonder kosten). Een file id of een /v1/files/… link werkt wel.

3. Start de clip, met een maximumbedrag

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 }'
  • Het antwoord komt direct met de job id, een poll_url en estimated_cost_usd.
  • Idempotency-Key: stuur hetzelfde verzoek opnieuw met dezelfde API key (na een verbroken verbinding, of een n8n herpoging) en je krijgt dezelfde job terug, niet een tweede.
  • models: backups, geprobeerd in volgorde wanneer de eerste geen vrije provider heeft.
  • max_cost: je maximumbedrag in Amerikaanse dollars. Een job die meer zou kosten, wordt geweigerd of geannuleerd zonder kosten. De factuur is wat de provider in rekening heeft gebracht, wat hoger kan zijn dan de prijs die aan het begin werd getoond wanneer een job naar een andere provider verhuist, dus stel dit in bij elke job.
  • Voeg "validate": true toe om het verzoek te controleren en te prijzen zonder iets te maken.

4. Wachten: pollen of een callback ontvangen

Pollen. Vraag poll_url elke 5 tot 10 seconden. Het antwoordt 202 terwijl de job queued of running is, en 200 zodra deze is beëindigd: succeeded, failed, canceled of expired. De laatste drie kosten niets. In de testruns duurde een clip van 5 seconden tussen de 1.5 en 5.5 minuten, dus reken minstens 15 minuten voordat je opgeeft; een job die niemand controleert, wordt nog steeds voltooid en gefactureerd, of terugbetaald. Alle statussen: Jobstatus.

Callback. Voeg "callback_url": "https://your-app.example/uberllm/jobs" toe aan het startverzoek en UberLLM stuurt een POST met de JSON van de job wanneer deze is beëindigd en de factuur definitief is. In n8n is dit een tweede workflow die begint met een Webhook node. Controleer de UberLLM-Signature header voordat je een bericht vertrouwt: Controleer de handtekening.

Bestand Link geldig
Een afbeelding op /v1/media/artifacts/… ongeveer 15 minuten
Een video ongeveer 3 uur nadat de job is beëindigd
Een bestand dat je hebt geüpload naar /v1/files 24 uur

Daarna antwoordt de link 404 artifact_expired. De recepten downloaden elk bestand zodra het bestaat. Om een clip direct in je eigen opslag te plaatsen, voeg je output_upload_url (een vooraf ondertekende PUT link) toe aan het startverzoek: Stuur resultaten naar je eigen opslag.

6. Spraak, ondertitels en de samenvoeging

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

Het spraakantwoord is de audio zelf; de kosten ervan staan in de X-UberLLM-Cost-USD header.

Veel advertenties vanuit een spreadsheet

Het spreadsheetrecept leest een CSV met de kolommen name, image_url, scene, motion en aspect_ratio (een voorbeeld). Een Google Sheet werkt zodra deze als CSV is gepubliceerd (Bestand → Delen → Publiceren op het web → CSV).

  • Het maakt de rijen aan die het nog niet eerder heeft aangemaakt, maximaal 5 per uitvoering tenzij je dit wijzigt.
  • Een rij die mislukt, stopt de andere niet en wordt opnieuw geprobeerd bij de volgende uitvoering.
  • In n8n wordt het geheugen van voltooide rijen opgeslagen wanneer de workflow actief is en volgens zijn planning wordt uitgevoerd. Een handmatige testuitvoering slaat dit niet op. Het script bewaart het in done.json in de uitvoermap, zodat het werkt vanuit cron.

Wat deze recepten niet doen

  • Clips samenvoegen, of een audiotrack of ondertitels op een clip plaatsen (dat is de ffmpeg-stap).
  • Sprekende avatars of lip-sync.
  • Je bestanden bewaren: download ze.
  • Controleer het resultaat. Een model kan een label, een kleur of een vorm veranderen, en het tekent de zijkanten die je foto niet toont. Bekijk elke afbeelding en clip voordat deze wordt uitgevoerd.

Voordat je advertenties plaatst

  • De mensen op deze foto's zijn AI-gegenereerd. Label ze waar het platform of je lokale wetgeving erom vraagt, en presenteer er nooit een als een echte klant, een getuigenis of een expert.
  • Houd gezondheidsclaims en voor/na-foto's uit prompts en voice-overs, en volg de regels van het advertentieplatform voor de categorie van je product.
  • Elk model heeft een maker wiens voorwaarden bepalen hoe de output mag worden gebruikt. Lees deze voor de modellen die je gebruikt, en gebruik alleen productfoto's waar je de rechten voor hebt.

Bronnen voor deze regels zijn gekoppeld op [de advertentie-creatiepagina]](https://uberllm.dev/ai-ad-creative-api#rules).