NouveauComment nous repérons un vendeur qui propose le mauvais modèle, et vous remboursons si cela arrive.
UberLLM

Flux de travail de créations publicitaires

Quatre recettes qui transforment une seule photo de produit en créations publicitaires, et le modèle qu'elles partagent. Chaque recette est un workflow n8n que vous importez par lien et une seule commande d'un script sans dépendances. Ce que chacun a produit et coûté lors d'une exécution réelle se trouve sur la page des créations publicitaires.

Recette workflow n8n (importation par lien) Commande de script
Une personne tenant le produit (image fixe 9:16), un extrait de cette image fixe, une ligne parlée ad-ugc-still-clip-voice.json ugc product.jpg
Variations statiques, une image par ligne d'une liste ad-static-variations.json variations product.jpg
Une image fixe et un extrait par ligne d'un fichier CSV ou d'une feuille Google Sheet, selon un calendrier ad-sheet-rows-to-ads.json sheet rows.csv
Une image fixe de studio du produit seul et un extrait de style plateau tournant ad-product-spin-video.json spin product.jpg

Les fichiers se trouvent dans le dépôt de modèles : les workflows dans workflows/, le script et la compétence d'agent dans skills/ad-creative/.

Lancer une exécution

Dans n8n. Importez le lien (⋯ → Importer depuis une URL…), créez un identifiant Header Auth (Nom Authorization, Valeur Bearer ull_...), modifiez le nœud Settings et cliquez sur « Exécuter le workflow ». Configuration complète : [n8n](video templates](/docs/n8n-video)).

En tant que script (Node 18 ou plus récent) :

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

Depuis un agent de codage (Claude Code et autres qui lisent les compétences) :

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

Le schéma que suit chaque recette

1. Créez l’image fixe au format que vous voulez

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 réponse contient l’image à data[0].url. Les modèles image vers vidéo de ces recettes produisent le clip au format de sa première image et n’acceptent pas de aspect_ratio (une requête qui en envoie une est refusée avant tout débit), donc le format est choisi ici : 9:16, 4:5 ou 1:1.

Une requête d’image répond quand l’image est prête. Elle peut expirer avec un 504, qui n’est pas facturé : renvoyez-la. Les recettes essaient jusqu’à trois fois.

2. Conservez l’image fixe et transmettez-la au modèle vidéo sous forme de fichier

L’image modifiée revient sous forme de lien vers /v1/media/artifacts/…, qui nécessite votre clé et reste valable environ 15 minutes. Téléchargez-la tout de suite, puis téléversez-la et utilisez l’ID du fichier comme image_url du 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

Ne transmettez pas un lien /v1/media/artifacts/… comme image_url d’une tâche vidéo. Un fournisseur ne peut pas ouvrir un lien qui nécessite votre clé, et la tâche échoue (sans frais). Un ID de fichier ou un lien /v1/files/… fonctionne.

3. Lancez le clip, avec un plafond

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 réponse arrive tout de suite avec l’ID de tâche id, un poll_url et estimated_cost_usd.
  • Idempotency-Key : renvoyez la même requête avec la même clé (après une connexion interrompue, ou une nouvelle tentative n8n) et vous récupérez la même tâche, pas une deuxième.
  • models : des solutions de secours, essayées dans l’ordre quand la première n’a pas de fournisseur libre.
  • max_cost : votre plafond en dollars US. Une tâche qui coûterait plus cher est refusée ou annulée sans frais. La facture correspond à ce que le fournisseur a facturé, ce qui peut être supérieur au prix affiché au départ quand une tâche passe à un autre fournisseur ; définissez donc ce plafond sur chaque tâche.
  • Ajoutez "validate": true pour vérifier et chiffrer la requête sans rien générer.

4. Attendez : interrogez ou recevez un callback

Interrogation. Interrogez poll_url toutes les 5 à 10 secondes. Il répond 202 tant que la tâche est queued ou running, et 200 une fois qu’elle est terminée : succeeded, failed, canceled ou expired. Les trois derniers ne coûtent rien. Lors des essais, un clip de 5 secondes a pris entre 1.5 et 5.5 minutes ; prévoyez donc au moins 15 minutes avant d’abandonner ; une tâche que personne ne vérifie est quand même terminée et facturée, ou remboursée. Tous les statuts : Statut de la tâche.

Callback. Ajoutez "callback_url": "https://your-app.example/uberllm/jobs" à la requête de démarrage et UberLLM envoie un POST avec le JSON de la tâche lorsqu’elle est terminée et que sa facture est définitive. Dans n8n, c’est un second workflow qui commence par un nœud Webhook. Vérifiez l’en-tête UberLLM-Signature avant de faire confiance à un message : Vérifiez la signature.

5. Téléchargez avant la fin du lien

Fichier Durée du lien
Une image sur /v1/media/artifacts/… environ 15 minutes
Une vidéo environ 3 heures après la fin de la tâche
Un fichier que vous avez téléversé sur /v1/files 24 heures

Après cela, le lien répond 404 artifact_expired. Les recettes téléchargent chaque fichier dès qu’il existe. Pour qu’un clip soit placé directement dans votre propre stockage, ajoutez output_upload_url (un lien PUT présigné) à la requête de démarrage : Envoyez les résultats dans votre propre stockage.

6. Voix, sous-titres et assemblage

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 réponse vocale est l’audio lui-même ; son coût se trouve dans l’en-tête X-UberLLM-Cost-USD.

De nombreuses annonces à partir d'une feuille

La recette de feuille lit un fichier CSV avec les colonnes name, image_url, scene, motion et aspect_ratio (un exemple). Une Google Sheet fonctionne une fois publiée au format CSV (Fichier → Partager → Publier sur le web → CSV).

  • Elle crée les lignes qu'elle n'a pas créées auparavant, au maximum 5 par exécution, sauf si vous le modifiez.
  • Une ligne qui échoue n'arrête pas les autres et est réessayée lors de la prochaine exécution.
  • In n8n la mémoire des lignes terminées est enregistrée lorsque le workflow est actif et s'exécute selon son calendrier. Une exécution de test manuelle ne l'enregistre pas. Le script le conserve dans done.json dans le dossier de sortie, afin qu'il fonctionne avec cron.

Ce que ces recettes ne font pas

  • Joindre des clips, ou ajouter une piste vocale ou des sous-titres à un clip (c'est l'étape ffmpeg).
  • Avatars parlants ou synchronisation labiale.
  • Conserver vos fichiers : téléchargez-les.
  • Vérifier le résultat. Un modèle peut modifier une étiquette, une couleur ou une forme, et il dessine les côtés que votre photo ne montre pas. Examinez chaque image et chaque clip avant de les utiliser.

Avant de lancer vos publicités

  • Les personnes sur ces images sont générées par IA. Étiquetez-les là où la plateforme ou votre législation locale l'exige, et ne les présentez jamais comme un vrai client, un témoignage ou un expert.
  • Évitez les allégations de santé et les images avant/après dans les prompts et les voix off, et respectez les règles de la plateforme publicitaire pour la catégorie de votre produit.
  • Chaque modèle a un créateur dont les conditions d'utilisation précisent comment sa sortie peut être utilisée. Lisez-les pour les modèles que vous utilisez, et n'utilisez que des photos de produits pour lesquelles vous avez les droits.

Les sources de ces règles sont disponibles sur la page des créations publicitaires.