Workflows für Werbemittel
Vier Rezepte, die ein Produktfoto in Werbemittel verwandeln, und das Muster, das sie gemeinsam haben. Jedes Rezept ist ein n8n Workflow, den Sie per Link importieren, und ein Befehl eines Skripts ohne Abhängigkeiten. Was jedes davon bei einem echten Durchlauf erstellt und gekostet hat, finden Sie auf der Werbemittel-Seite.
| Rezept | n8n Workflow (Import per Link) | Skriptbefehl |
|---|---|---|
| Eine Person, die das Produkt hält (9:16 Standbild), ein Clip aus diesem Standbild, eine gesprochene Zeile | ad-ugc-still-clip-voice.json | ugc product.jpg |
| Statische Variationen, ein Bild pro Zeile einer Liste | ad-static-variations.json | variations product.jpg |
| Ein Standbild und ein Clip pro Zeile einer CSV-Datei oder eines Google Sheets, nach einem Zeitplan | ad-sheet-rows-to-ads.json | sheet rows.csv |
| Ein Studio-Standbild des Produkts allein und ein Clip im Plattenspieler-Stil | ad-product-spin-video.json | spin product.jpg |
Die Dateien befinden sich in
dem Vorlagen-Repository:
Workflows in workflows/, das Skript und die Agenten-Fähigkeit in skills/ad-creative/.
Ausführen
In n8n. Den Link importieren (⋯ → Von URL importieren…), ein Header Auth-Zugangsdaten erstellen (Name Authorization, Wert Bearer ull_...), den Settings-Knoten bearbeiten und auf Workflow ausführen klicken. Vollständige Einrichtung: n8n Video-Vorlagen.
Als Skript (Node 18 oder neuer):
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
Von einem Coding-Agenten (Claude Code und andere, die Fähigkeiten lesen):
npx skills add PSA-Team-source/uberllm-n8n-templates --skill ad-creative
Das Muster, dem jedes Rezept folgt
1. Erstellen Sie das Standbild in der gewünschten Form
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 }'
Die Antwort enthält das Bild unter data[0].url. Die Bild-zu-Video-Modelle in diesen Rezepten erstellen den Clip in der Form ihres ersten Bildes und nehmen keine aspect_ratio (eine Anfrage, die eine sendet, wird vor jeglicher Gebühr abgelehnt), daher wird die Form hier gewählt: 9:16, 4:5 oder 1:1.
Eine Bildanfrage antwortet, sobald das Bild fertig ist. Sie kann mit einem 504 ablaufen, das nicht berechnet wird: Senden Sie sie erneut. Die Rezepte versuchen es bis zu dreimal.
2. Behalten Sie das Standbild und übergeben Sie es dem Videomodell als Datei
Das bearbeitete Bild kommt als Link zu /v1/media/artifacts/… zurück, der Ihren key benötigt und etwa 15 Minuten gültig ist. Laden Sie es sofort herunter, laden Sie es dann hoch und verwenden Sie die file id als image_url des Clips:
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
Übergeben Sie keinen /v1/media/artifacts/… Link als image_url eines Video-Jobs. Ein provider kann einen Link, der Ihren key benötigt, nicht öffnen, und der Job schlägt fehl (kostenlos). Eine file id oder ein /v1/files/… Link funktioniert.
3. Starten Sie den Clip, mit einer Obergrenze
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 }'
- Die Antwort kommt sofort mit dem job
id, einempoll_urlundestimated_cost_usd. Idempotency-Key: Senden Sie dieselbe request erneut mit demselben key (nach einer unterbrochenen Verbindung oder einem n8n retry) und Sie erhalten denselben job zurück, keinen zweiten.models: backups, der Reihe nach versucht, wenn der erste keinen freien provider hat.max_cost: Ihre Obergrenze in US-Dollar. Ein job, der mehr kosten würde, wird kostenlos abgelehnt oder storniert. Die Rechnung ist das, was der provider berechnet hat, was über dem zu Beginn angezeigten Preis liegen kann, wenn ein job zu einem anderen provider wechselt, also legen Sie dies für jeden job fest.- Fügen Sie
"validate": truehinzu, um die request zu prüfen und zu bepreisen, ohne etwas zu erstellen.
4. Warten: poll oder einen callback erhalten
Poll. Fragen Sie poll_url alle 5 bis 10 Sekunden. Es antwortet 202, während der job queued oder running ist, und 200, sobald er beendet ist: succeeded, failed, canceled oder expired. Die letzten drei kosten nichts. In den Testläufen dauerte ein 5-Sekunden-Clip zwischen 1.5 und 5.5 Minuten, also planen Sie mindestens 15 Minuten ein, bevor Sie aufgeben; ein job, den niemand überprüft, wird trotzdem abgeschlossen und abgerechnet oder erstattet. Alle statuses: Job-Status.
Callback. Fügen Sie "callback_url": "https://your-app.example/uberllm/jobs" zur Start-request hinzu und UberLLM sendet einen POST mit dem JSON des jobs, wenn dieser beendet ist und die Rechnung endgültig ist. In n8n ist dies ein zweiter workflow, der mit einem Webhook node beginnt. Überprüfen Sie den UberLLM-Signature header, bevor Sie einer Nachricht vertrauen: Überprüfen Sie die Signatur.
5. Herunterladen, bevor der Link abläuft
| Datei | Link gültig |
|---|---|
Ein Bild unter /v1/media/artifacts/… |
etwa 15 Minuten |
| Ein Video | etwa 3 Stunden nach Beendigung des jobs |
Eine Datei, die Sie auf /v1/files hochgeladen haben |
24 Stunden |
Danach antwortet der Link 404 artifact_expired. Die Rezepte laden jede Datei herunter, sobald sie existiert. Um einen Clip direkt in Ihren eigenen storage zu legen, fügen Sie output_upload_url (einen presigned PUT Link) zur Start-request hinzu: Ergebnisse an Ihren eigenen storage senden.
6. Stimme, Untertitel und die Zusammenführung
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
Die Sprachantwort ist das audio selbst; ihre Kosten stehen im X-UberLLM-Cost-USD header.
Viele Anzeigen aus einer Tabelle
Das Tabellenrezept liest eine CSV-Datei mit den Spalten name, image_url, scene, motion und
aspect_ratio (ein Beispiel).
Ein Google Sheet funktioniert, sobald es als CSV veröffentlicht wird (Datei → Teilen → Im Web veröffentlichen → CSV).
- Es erstellt die Zeilen, die es zuvor noch nicht erstellt hat, höchstens 5 pro Durchlauf, es sei denn, Sie ändern es.
- Eine Zeile, die fehlschlägt, hält die anderen nicht auf und wird beim nächsten Durchlauf erneut versucht.
- In n8n wird der Speicher der abgeschlossenen Zeilen gespeichert, wenn der Workflow aktiv ist und nach seinem Zeitplan läuft. Ein manueller Testlauf speichert ihn nicht. Das Skript behält ihn in
done.jsonim Ausgabeordner, damit es von cron funktioniert.
Was diese Rezepte nicht tun
- Clips zusammenfügen oder eine Tonspur oder Untertitel zu einem Clip hinzufügen (das ist der ffmpeg-Schritt).
- Sprechende Avatare oder Lippensynchronisation.
- Ihre Dateien behalten: Laden Sie sie herunter.
- Überprüfen Sie das Ergebnis. Ein Modell kann ein Etikett, eine Farbe oder eine Form ändern, und es zeichnet die Seiten, die Ihr Foto nicht zeigt. Sehen Sie sich jedes Bild und jeden Clip an, bevor es läuft.
Bevor Sie Anzeigen schalten
- Die Personen auf diesen Bildern sind KI-generiert. Kennzeichnen Sie sie, wo die Plattform oder Ihr lokales Gesetz es verlangt, und stellen Sie niemals eine Person als echten Kunden, als Referenz oder als Experten dar.
- Halten Sie Gesundheitsaussagen und Vorher-Nachher-Bilder von Prompts und Sprachaufnahmen fern, und befolgen Sie die Regeln der Anzeigenplattform für die Kategorie Ihres Produkts.
- Jedes Modell hat einen Hersteller, dessen Bedingungen festlegen, wie seine Ausgabe verwendet werden darf. Lesen Sie diese für die Modelle, die Sie verwenden, und verwenden Sie nur Produktfotos, für die Sie die Rechte besitzen.
Quellen für diese Regeln sind auf der Seite für Anzeigen-Creatives verlinkt.