mcpField
M
muapi-product-ad-cinematic

muapi-product-ad-cinematic

github.com/samuraigptマーケティング・グロース864 回インストール4 週間前に更新
リポジトリ

muapi-product-ad-cinematic について

muapi-product-ad-cinematic は、アップロード済みの商品写真とブランドブリーフから 5~10 秒の広告を作るエージェントスキルです。まずヒーローフレームを 4 案生成して選択を待ち、選ばれた画像から音楽付き動画を作成します。

主な機能

  1. 01商品写真とブランドブリーフの入力
  2. 02ヒーローフレームを 4 案生成
  3. 03動画生成前のユーザー選択
  4. 04画像のアップスケールと動画化
  5. 05バックグラウンド音楽の生成

活用シーン

  1. 01短いシネマティックな商品広告の制作
  2. 02商品のビジュアル方向性の検討
  3. 03音楽付きブランド動画の生成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/samuraigpt/muapi-skills --skill muapi-product-ad-cinematic

インストール後、Claude Code で/muapi-product-ad-cinematicを入力して読み込まれたか確認します。

詳細

シネマティックな商品広告

商品写真とブランドブリーフから、5~10秒のシネマティックな商品広告を作成します。

入力

名前種類必須デフォルト説明
product_imageimage_urlはい—商品写真の URL(事前にアップロードされている必要があります)。
brand_brieftextはい—ムード/スタイルの方向性(例:「高級感のあるミニマル」「遊び心のある」)。
duration_secintいいえ6最終動画の長さ(秒)(5~10)。

手順

このスキルは、ユーザーが選択するステップを挟んだ2つのフェーズで構成されます。2つの 別々の plan 呼び出しとして送信してください。後続のステップを最初の plan にまとめてはいけません。

フェーズ A — バリエーションの検討(低コスト)

以下のみを含む plan を1つ送信します。

  1. ヒーローフレームのバリエーション — muapi image generate ノードを4つ個別に実行 (デフォルトでは model=nano-banana-2、aspect_ratio=16:9)。
    • 各プロンプトでは、ブランドブリーフのムードに合わせて商品をスタイリングし直します。バリエーションごとに、 照明、配色、フレーミング、レンズを変えます。商品の形状は変えないでください。
    • モデルが画像による条件付けに対応している場合は、ユーザーの product_image を参照してください。対応していない場合は、商品を詳しく説明してください。

plan の実行後、4つの asset_ids を簡潔に列挙し、どれを次の工程に進めるかユーザーに尋ねてターンを終了してください(例: 「どのヒーローを選びますか(asset_1、asset_2、asset_3、asset_4)?」)。返答を待ちます。

フェーズ B — 選択したヒーローで確定(高コスト)

ユーザーが選択を返信したら、2つ目の plan を送信します。

  1. 選択したフレームをアップスケール — enhance_image(operation=upscale)。
  2. アップスケールしたフレームをアニメーション化 — muapi video from-image(model=kling-v3.0-standard-image-to-video、 duration={{duration_sec}}, prompt="slow cinematic push-in, soft volumetric light, subtle product micro-rotation")。アップスケールした画像の URL を $nX.url で参照します。
  3. BGM — muapi audio create(kind=music)。アップスケール/アニメーション化と並行して実行します。 スタイルは brand_brief に基づいて決めます(高級感なら → "ambient cinematic, warm strings, slow tempo, instrumental")。長さは 動画とほぼ同じにします。
  4. アップスケールしたヒーロー画像と最終動画を返します。

注意事項

  • ブリーフに「高級感」が含まれる場合は金色/黒を、「遊び心」が含まれる場合は明るく/彩度の高い色を優先します。
  • フェイルオーバー後に動画生成に失敗した場合は、静止画のスライドショーに切り替えます (アップスケールしたヒーロー画像と音楽のみを返します)。
  • ステップ4を自動で確定しないでください。費用(約80 cr)に見合うユーザーの確認が必要です。

トリガーキーワード

product ad、commercial、cinematic ad、product video


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

  • このレシピは 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 '{...}' で raw endpoint にフォールバックし、muapi predict wait <request_id> でポーリングしてください。
  • 各呼び出しの前に、{{input_name}} プレースホルダーをユーザーの実際の入力に置き換えてください。

コメント