新着違うモデルを出品する販売者をどう見抜き、どう返金するか。
UberLLM

広告クリエイティブのワークフロー

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によって生成されています。プラットフォームまたは現地の法律で求められる場合はその旨を明記し、実際の顧客、推薦文、または専門家として提示しないでください。
  • 健康に関する主張やビフォーアフターの写真をプロンプトや音声から除外し、製品のカテゴリに関する広告プラットフォームのルールに従ってください。
  • 各モデルには、その出力の使用方法を定める利用規約を持つメーカーがあります。使用するモデルについてはそれらの規約を読み、権利を持つ製品写真のみを使用してください。

これらのルールの出典は、広告クリエイティブページ]にリンクされています。