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, eenpoll_urlenestimated_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": truetoe 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.
5. Download voordat de link verloopt
| 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.jsonin 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).