NeuSo erkennen wir Verkäufer, die das falsche Modell anbieten – und du bekommst dein Geld zurück.
UberLLM

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, einem poll_url und estimated_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": true hinzu, 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.

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