muapi-ugc-ads-workflow

UGC 広告ワークフロー

人物の自撮り写真と商品画像を組み合わせ、動画スクリプトとアニメーション広告を生成して、ユーザー生成コンテンツ（UGC）動画広告を作成します。

入力

名前	種類	必須	デフォルト	説明
product_name	text	はい	—	広告する商品の名前です（例：「Blume SuperBalm in plum」）。
human_image	image_url	いいえ	—	人物インフルエンサーの自撮り写真または写真です。
product_image	image_url	いいえ	—	商品がはっきり写った写真です。

手順

フェーズ A — 画像の組み合わせ

{{human_image}} または {{product_image}} が提供されていない場合は、ユーザーにアップロードを依頼するか、生成を提案してください。

両方の画像がそろったら、組み合わせるためのプランを 1 つのステップで送信します。

1. 画像生成 — muapi image edit（model=gpt-image-2-text-to-image）：
   • 参照画像：{{human_image}} と {{product_image}} の両方を使用します。
   • プロンプト：A natural, candid UGC-style photo of the influencer from the first reference image holding and showcasing the product from the second reference image. The influencer is smiling genuinely at the camera, holding the product up. Natural indoor lighting, lifestyle aesthetic, high quality.
   • アスペクト比：9:16（TikTok／Reels／Shorts 向けの縦長）。

組み合わせた画像をユーザーに提示し、承認を得てください。

フェーズ B — スクリプトと動画の生成

1. 調査とスクリプト作成：ウェブ検索ツールを使用して {{product_name}} の詳細を調べ、主な利点を把握します。

2. 調査に基づいて、次の形式を参考に、タイムスタンプ付きの UGC スタイルの動画スクリプトを作成します。

   (0-2s) インフルエンサーが {{product_name}} を持ち、カメラに向かって自然な笑顔を見せます。 「ねえ、私がいつも毎日使える完璧な商品を探しているの、知ってる？」 (2-7s) インフルエンサーが商品をカメラに近づけて見せます… 「ついに見つけたの！この {{product_name}}、本当にすごくいいの。」 (7-12s) インフルエンサーが商品を使う／塗ります。 「使い心地が最高で、ちゃんと効果もあるの。」 (12-15s) インフルエンサーが笑顔を見せ、少し口をすぼめ、気軽に肩をすくめるか、うなずいて気に入った様子を示します。 「もうすっかりお気に入り。ぜひ試してみて！」

3. 動画生成：画像から動画を生成するモデル（例：sd-2-omni-reference または veo3.1-image-to-video）を使ってプランを送信します。

   • 参照画像：フェーズ A で作成した画像。
   • プロンプト：作成したスクリプトの視覚的な動作を使います。例：A UGC-style video. The influencer holds the {{product_name}}, smiling genuinely. She brings it closer to the camera to show the label, then applies it smoothly. She nods in approval and smiles. Natural movements, talking to the camera, lifestyle vlog style.
   • アスペクト比：9:16

動画の生成後、ユーザーが自分でナレーションを録音したり、後からリップシンクツールを使ったりできるよう、作成したスクリプトと一緒に動画を提示してください。

トリガーキーワード

ugc ad、ugc video、influencer ad、product ad video、combine product and human

---

実行エージェント向けの注意事項

• このレシピは LLM がオーケストレーションします。各フェーズを読み、ユーザーから不足している入力を集めてから、muapi CLI コマンドを呼び出してください。MUAPI_API_KEY が未設定の場合は、最初に muapi auth configure を実行してください。
• まだ CLI エイリアスがないモデル ID の場合は、curl -X POST https://api.muapi.ai/api/v1/<endpoint> -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}' を使って生のエンドポイントにフォールバックし、muapi predict wait <request_id> でポーリングしてください。
• 各呼び出しを実行する前に、{{input_name}} プレースホルダーをユーザーの実際の入力に置き換えてください。