Flujos de trabajo para creatividades publicitarias
Cuatro recetas que transforman una foto de producto en creatividades publicitarias, y el patrón que comparten. Cada receta es un flujo de trabajo n8n que se importa mediante un enlace y un solo comando de un script sin dependencias. Lo que cada una produjo y costó en una ejecución real está en la página de creatividades publicitarias.
| Receta | Flujo de trabajo n8n (importar por enlace) | Comando de script |
|---|---|---|
| Una persona sosteniendo el producto (imagen fija 9:16), un clip de esa imagen fija, una línea hablada | ad-ugc-still-clip-voice.json | ugc product.jpg |
| Variaciones estáticas, una imagen por línea de una lista | ad-static-variations.json | variations product.jpg |
| Una imagen fija y un clip por fila de un archivo CSV o Google Sheet, programado | ad-sheet-rows-to-ads.json | sheet rows.csv |
| Una imagen fija de estudio del producto solo y un clip estilo tocadiscos | ad-product-spin-video.json | spin product.jpg |
Los archivos están en el repositorio de plantillas: los flujos de trabajo en workflows/, el script y la habilidad del agente en skills/ad-creative/.
Ejecutar uno
En n8n. Importa el enlace (⋯ → Importar desde URL…), crea una credencial de Header Auth
(Nombre Authorization, Valor Bearer ull_...), edita el nodo de Settings y
haz clic en Execute workflow. Configuración completa: n8n plantillas de video.
Como script (Node 18 o posterior):
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
Desde un agente de codificación (Claude Code y otros que leen habilidades):
npx skills add PSA-Team-source/uberllm-n8n-templates --skill ad-creative
El patrón que sigue cada receta
1. Cree la imagen fija con la forma que desee
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 respuesta contiene la imagen en data[0].url. Los modelos de imagen a vídeo de estas recetas
crean el clip con la forma de su primera imagen y no aceptan aspect_ratio (una solicitud
que envía uno es rechazada antes de cualquier cargo), por lo que la forma se elige aquí: 9:16, 4:5
o 1:1.
Una solicitud de imagen responde cuando la imagen está lista. Puede agotar el tiempo de espera con un 504, que
no se cobra: envíela de nuevo. Las recetas lo intentan hasta tres veces.
2. Conserve la imagen fija y entréguela al modelo de vídeo como un archivo
La imagen editada se devuelve como un enlace a /v1/media/artifacts/…, que necesita su clave
y dura unos 15 minutos. Descárguela de inmediato, luego súbala y use el ID del archivo como el
image_url del 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
No pase un enlace /v1/media/artifacts/… como image_url de un trabajo de vídeo. Un proveedor
no puede abrir un enlace que necesita su clave, y el trabajo falla (sin cargo). Un ID de archivo o un
enlace /v1/files/… funciona.
3. Inicie el clip, con un límite máximo
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 respuesta llega de inmediato con el
iddel trabajo, unpoll_urlyestimated_cost_usd. Idempotency-Key: envíe la misma solicitud de nuevo con la misma clave (después de una conexión perdida, o un reintento n8n) y recuperará el mismo trabajo, no un segundo.models: copias de seguridad, probadas en orden cuando el primero no tiene un proveedor libre.max_cost: su límite máximo en dólares estadounidenses. Un trabajo que costaría más es rechazado o cancelado sin cargo. La factura es lo que cobró el proveedor, lo que puede estar por encima del precio mostrado al inicio cuando un trabajo se mueve a otro proveedor, así que establezca esto en cada trabajo.- Añada
"validate": truepara verificar y tasar la solicitud sin crear nada.
4. Espere: sondee o reciba una devolución de llamada
Sondeo. Pregunte a poll_url cada 5 a 10 segundos. Responde 202 mientras el trabajo está
queued o running, y 200 una vez que ha terminado: succeeded, failed, canceled o
expired. Los últimos tres no cuestan nada. En las pruebas, un clip de 5 segundos tardó entre
1.5 y 5.5 minutos, así que espere al menos 15 minutos antes de rendirse; un trabajo que nadie verifica
aún se finaliza y se factura, o se reembolsa. Todos los estados: Estado del trabajo.
Devolución de llamada. Añada "callback_url": "https://your-app.example/uberllm/jobs" a la solicitud de inicio
y UberLLM envía un POST con el JSON del trabajo cuando este ha terminado y su factura
es final. En n8n, este es un segundo flujo de trabajo que comienza con un nodo Webhook.
Verifique el encabezado UberLLM-Signature antes de confiar en un mensaje: Verificar la firma.
5. Descargue antes de que el enlace caduque
| Archivo | El enlace dura |
|---|---|
Una imagen en /v1/media/artifacts/… |
unos 15 minutos |
| Un vídeo | unas 3 horas después de que termine el trabajo |
Un archivo que subió a /v1/files |
24 horas |
Después de eso, el enlace responde 404 artifact_expired. Las recetas descargan cada archivo tan
pronto como existe. Para que un clip se guarde directamente en su propio almacenamiento, añada
output_upload_url (un enlace PUT pre-firmado) a la solicitud de inicio:
Enviar resultados a su propio almacenamiento.
6. Voz, subtítulos y la unión
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 respuesta de voz es el audio en sí; su coste está en el encabezado X-UberLLM-Cost-USD.
Muchos anuncios desde una hoja
La receta de la hoja lee un CSV con las columnas name, image_url, scene, motion y aspect_ratio (un ejemplo).
Una Hoja de cálculo de Google funciona una vez que se publica como CSV (Archivo → Compartir → Publicar en la web → CSV).
- Crea las filas que no ha creado antes, como máximo 5 por ejecución a menos que lo cambies.
- Una fila que falla no detiene a las demás y se intenta de nuevo en la siguiente ejecución.
- En n8n la memoria de las filas terminadas se guarda cuando el flujo de trabajo está activo y se ejecuta según su programación. Una ejecución de prueba manual no la guarda. El script la guarda en
done.jsonen la carpeta de salida, para que funcione desde cron.
Lo que estas recetas no hacen
- Unir clips, o añadir una pista de voz o subtítulos a un clip (eso es el paso de ffmpeg).
- Avatares que hablan o sincronización labial.
- Guardar tus archivos: descárgalos.
- Revisa el resultado. Un modelo puede cambiar una etiqueta, un color o una forma, y dibuja los lados que tu foto no muestra. Revisa cada imagen y clip antes de que se ejecute.
Antes de publicar anuncios
- Las personas en estas imágenes son generadas por IA. Etiquétalas donde la plataforma o tu ley local lo exija, y nunca las presentes como un cliente real, un testimonio o un experto.
- Mantén las afirmaciones de salud y las imágenes de antes/después fuera de los prompts y las líneas de voz, y sigue las reglas de la plataforma publicitaria para la categoría de tu producto.
- Cada modelo tiene un creador cuyos términos establecen cómo se puede usar su resultado. Léelos para los modelos que uses, y usa solo fotos de productos para las que tengas los derechos.
Las fuentes de estas reglas están enlazadas en la página de creatividades publicitarias.