広告クリエイティブのワークフロー
1枚の商品写真から広告クリエイティブを作成する4つのレシピと、それらが共有するパターン。 各レシピは、リンクでインポートでき、依存関係のないスクリプトの1つのコマンドで実行できるn8nのワークフローです。実際の実行でそれぞれが作成したものと費用は、広告クリエイティブのページ]にあります。
| レシピ | n8nワークフロー(リンクでインポート) | スクリプトコマンド |
|---|---|---|
| 商品を持っている人(9:16静止画)、その静止画からのクリップ、音声付きのセリフ | ad-ugc-still-clip-voice.json | ugc product.jpg |
| 静止画のバリエーション、リストの1行につき1枚の画像 | ad-static-variations.json | variations product.jpg |
| CSVファイルまたはGoogleシートの1行につき1枚の静止画と1つのクリップを、スケジュールに基づいて | 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ノードを編集して「ワークフローを実行」をクリックします。完全なセットアップは: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を受け付けません(これを送信するリクエストは、課金前に拒否されます)。そのため、形はここで選択されます:9:16、4:5、または1:1。
画像リクエストは、画像が準備できたときに回答します。504でタイムアウトすることがありますが、これは課金されません。再度送信してください。レシピは最大3回試行します。
2. 静止画を保持し、ファイルとして動画モデルに渡す
編集された画像は、/v1/media/artifacts/…へのリンクとして返されます。これにはあなたのkeyが必要で、約15分間有効です。すぐにダウンロードし、その後アップロードして、そのfile 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
動画ジョブのimage_urlとして/v1/media/artifacts/…リンクを渡さないでください。プロバイダーはあなたのkeyを必要とするリンクを開くことができず、ジョブは失敗します(課金なし)。file 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 }'
- 回答は、job
id、poll_url、およびestimated_cost_usdとともにすぐに返されます。 Idempotency-Key: 同じkeyで同じリクエストを再度送信すると(接続が切断された後、またはn8n回の再試行後)、2つ目のジョブではなく、同じジョブが返されます。models: バックアップ。最初のプロバイダーに空きがない場合に順に試行されます。max_cost: 米ドルでの上限。これより費用がかかるジョブは拒否されるか、課金なしでキャンセルされます。請求額はプロバイダーが請求した金額であり、ジョブが別のプロバイダーに移動した場合、開始時に表示された価格を超えることがあります。そのため、すべてのジョブでこれを設定してください。"validate": trueを追加すると、何も作成せずにリクエストをチェックし、価格を調べることができます。
4. 待機:ポーリングまたはコールバックの受信
ポーリング。 poll_urlに5から10秒ごとに問い合わせてください。ジョブがqueuedまたはrunningの間は202と回答し、終了すると200と回答します:succeeded、failed、canceled、またはexpired。最後の3つは費用がかかりません。テスト実行では、5秒のクリップは1.5から5.5分かかったため、諦める前に少なくとも15分は待機してください。誰も確認しないジョブでも、完了して請求されるか、返金されます。すべてのステータス:Job status。
コールバック。 開始リクエストに"callback_url": "https://your-app.example/uberllm/jobs"を追加すると、UberLLMはジョブが終了し、請求が確定したときに、ジョブのJSONを含むPOSTを送信します。n8nでは、これはWebhookノードで始まる2番目のワークフローです。メッセージを信頼する前にUberLLM-Signatureヘッダーを確認してください:Check the signature。
5. リンクが期限切れになる前にダウンロードする
| ファイル | リンクの有効期間 |
|---|---|
/v1/media/artifacts/…の画像 |
約15分 |
| 動画 | ジョブ終了後約3時間 |
/v1/filesにアップロードしたファイル |
24時間 |
その後、リンクは404 artifact_expiredと回答します。レシピは、ファイルが存在するとすぐにすべてダウンロードします。クリップを直接自分のストレージに保存するには、開始リクエストにoutput_upload_url(署名済みPUTリンク)を追加してください:Send results to your own storage。
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ヘッダーに含まれています。
シートから多数の広告
シートのレシピは、name, image_url, scene, motion, aspect_ratio の列を持つCSVを読み込みます (サンプル])。
Googleシートは、CSVとして公開されると機能します(ファイル → 共有 → ウェブに公開 → CSV)。
- 以前に作成していない行を作成します。変更しない限り、1回の実行につき最大5件です。
- 失敗した行は他の行を止めず、次回の実行で再度試行されます。
- n8nでは、ワークフローがアクティブでスケジュールから実行されるときに、完了した行の記憶が保存されます。手動のテスト実行では保存されません。スクリプトは出力フォルダの
done.jsonにそれを保持するため、cronから機能します。
これらのレシピではできないこと
- クリップの結合、またはクリップへの音声トラックやキャプションの追加(それはffmpegのステップです)。
- 話すアバターやリップシンク。
- ファイルの保持はしません。ダウンロードしてください。
- 結果の確認。モデルはラベル、色、形状を変更したり、写真に写っていない側面を描画したりすることがあります。実行前にすべての画像とクリップを確認してください。
広告を掲載する前に
- これらの写真の人物はAIによって生成されています。プラットフォームまたは現地の法律で求められる場合はその旨を明記し、実際の顧客、推薦文、または専門家として提示しないでください。
- 健康に関する主張やビフォーアフターの写真をプロンプトや音声から除外し、製品のカテゴリに関する広告プラットフォームのルールに従ってください。
- 各モデルには、その出力の使用方法を定める利用規約を持つメーカーがあります。使用するモデルについてはそれらの規約を読み、権利を持つ製品写真のみを使用してください。
これらのルールの出典は、広告クリエイティブページ]にリンクされています。