广告创意工作流
四个方案,能将一张产品照片转化为广告创意,并展示它们共有的模式。每个方案都是一个 n8n 工作流,你可以通过链接导入,并使用一个无需任何依赖的脚本命令。每个方案在实际运行中生成的内容和成本,请访问 广告创意页面 查看。
| 方案 | n8n 工作流(通过链接导入) | 脚本命令 |
|---|---|---|
| 一个人手持产品 (9:16 静态图),从该静态图生成的短片,一段旁白 | ad-ugc-still-clip-voice.json | ugc product.jpg |
| 静态变体,列表中每行一张图片 | ad-static-variations.json | variations product.jpg |
| CSV 文件或 Google 表格的每行一张静态图和一个短片,按计划生成 | ad-sheet-rows-to-ads.json | sheet rows.csv |
| 产品单独的影棚静态图和一个转盘式短片 | ad-product-spin-video.json | spin product.jpg |
文件位于 模板仓库:工作流在 workflows/,脚本和代理技能在 skills/ad-creative/。
运行一次
在 n8n 中。 导入链接 (⋯ → 从 URL 导入…),创建一个 Header Auth 凭据 (名称 Authorization, 值 Bearer ull_...),编辑 Settings 节点并点击 Execute workflow。完整设置:n8n 视频模板。
作为脚本 (Node 18 或更高版本):
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
从编码代理 (Claude Code 以及其他能读取技能的代理):
npx skills add PSA-Team-source/uberllm-n8n-templates --skill ad-creative
每个配方都遵循的模式
1. 制作你想要的静止图像形状
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 }'
答案在data[0].url处包含图片。这些配方中的图像转视频模型会根据其第一张图片的形状制作视频片段,并且不接受aspect_ratio(发送aspect_ratio的请求会在收费前被拒绝),因此形状在此处选择:9:16、4:5或1:1。
图片请求在图片准备好时返回答案。它可能会因504而超时,这不收费:请再次发送。这些配方最多尝试三次。
2. 保留静止图像,并将其作为文件传递给视频模型
编辑后的图片会以/v1/media/artifacts/…的链接形式返回,该链接需要你的key,并持续约15分钟。立即下载,然后上传并使用文件ID作为视频片段的image_url:
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
请勿将/v1/media/artifacts/…链接作为视频作业的image_url传递。提供商无法打开需要你的key的链接,作业将失败(不收费)。文件ID或/v1/files/…链接有效。
3. 启动视频片段,并设置上限
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 }'
- 答案会立即返回,包含作业
id、poll_url和estimated_cost_usd。 Idempotency-Key:使用相同的key再次发送相同的请求(在连接断开或n8n重试后),你将获得相同的作业,而不是第二个。models:备用,当第一个提供商没有空闲时按顺序尝试。max_cost:你的美元费用上限。费用超出此上限的作业将被拒绝或取消,不收取任何费用。账单是提供商收取的费用,当作业转移到另一个提供商时,该费用可能高于开始时显示的价格,因此请为每个作业设置此项。- 添加
"validate": true以检查和估算请求价格,而不实际创建任何内容。
4. 等待:轮询或接收回调
轮询。 每隔5到10秒询问poll_url。当作业处于queued或running状态时,它会返回202;一旦作业结束,它会返回200:succeeded、failed、canceled或expired。最后三个不收费。在测试运行中,一个5秒的视频片段耗时在1.5到5.5分钟之间,因此在放弃之前至少等待15分钟;无人检查的作业仍会完成并计费或退款。所有状态:作业状态。
回调。 在启动请求中添加"callback_url": "https://your-app.example/uberllm/jobs",当作业结束且账单最终确定时,UberLLM会发送一个包含作业JSON的POST。在n8n中,这是以Webhook节点开始的第二个工作流。在信任消息之前检查UberLLM-Signature header:检查签名。
5. 在链接失效前下载
| 文件 | 链接有效期 |
|---|---|
/v1/media/artifacts/…处的图片 |
约15分钟 |
| 视频 | 作业结束后约3小时 |
你上传到/v1/files的文件 |
24小时 |
之后,链接会返回404 artifact_expired。这些配方会在文件一经生成就立即下载。要将视频片段直接存入你自己的存储空间,请在启动请求中添加output_upload_url(一个预签名的PUT链接):将结果发送到你自己的存储空间。
6. 语音、字幕和拼接
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
语音答案就是音频本身;其费用在X-UberLLM-Cost-USD header中。
从工作表生成多个广告
该工作表配方读取一个包含列 name、image_url、scene、motion 和 aspect_ratio 的 CSV(一个 示例)。
Google 表格在发布为 CSV 后即可使用(文件 → 共享 → 发布到网络 → CSV)。
- 它会创建之前未创建过的行,每次运行最多 5 行,除非您更改它。
- 失败的行不会阻止其他行,并在下次运行时再次尝试。
- 在 n8n 中,当工作流处于活动状态并按其计划运行时,已完成行的记忆会被保存。手动测试运行不会保存它。脚本将其保存在输出文件夹中的
done.json,因此它可以通过 cron 运行。
这些方法无法实现的功能
- 拼接片段,或在片段上添加音轨或字幕(那是 ffmpeg 步骤)。
- 会说话的虚拟形象或唇形同步。
- 保留您的文件:请下载它们。
- 检查结果。模型可能会改变标签、颜色或形状,并且它会绘制您的照片未显示的 侧面。在运行之前,请查看每张图片和每个片段。
投放广告前须知
- 这些图片中的人物是AI生成的。在平台或当地法律要求时,请注明,绝不能将其呈现为真实客户、推荐语或专家。
- 提示词和语音内容中请勿包含健康声明和前后对比图片,并请遵守广告平台针对您产品类别的规定。
- 每个模型都有其制作者,其条款规定了其输出内容的使用方式。请阅读您所使用模型的条款,并且只使用您拥有使用权的产品照片。
这些规则的来源已链接到广告素材页面。