ブラックフライデーチャージボーナス·$50以上のチャージで$10プレゼント · $100以上のチャージで$25プレゼント·11月30日までチャージ →
ユースケース

AI UGC広告:
1つのAPIキーで商品カット、出演者、ナレーション

コードからUGC風の動画広告を作る方法: 画像APIで商品写真、台詞を話す出演者の動画ショットまたはスワップ、テキスト読み上げでナレーション。

最終更新日 2026-11-05

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで
party.mp4 · 1:004 ショット · 2 人shot 1shot 2shot 3shot 4p1chr_miap2"keep"shot 3 · p1 → chr_miaswapped.mp4置き換え済みそのまま置き換え済み置き換え済み元の音声
ブラックフライデー

ブラックフライデーチャージボーナス

対象のチャージごとに無料クレジットが付き、他の特典とも併用できます。

11月30日まで

$50をチャージ
+$10
20%ボーナス
$100をチャージ
+$25
25%ボーナス
登録して受け取る

UGC風の広告とは、人物があなたの商品を持ち、友達に話すようにカメラへ語りかける、縦長の短いクリップ数本に編集された動画です。そのパーツは、前払いの1つのキーで、コードから作れます。商品カットは画像生成API、出演者は動画ショット(保存したキャラクターが自分の声で台本を話す)または撮影済みの映像へのキャラクタースワップ、任意のナレーションはテキスト読み上げです。このページでは、どのAPIがどのパーツを作るのか、そして何がまだあなたの仕事なのか(台本、確認、編集、開示)を説明します。

AI エージェントに任せる

このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。

Build a pipeline that turns product photos and an ad script into vertical UGC-style video ads with the Lovely Router images, video shots, joins and speech APIs.

- Docs (read first): https://lovelyrouter.com/docs/models/images.md and https://lovelyrouter.com/docs/api/video-shots.md and https://lovelyrouter.com/docs/api/audio.md
- Images: POST https://lovelyrouter.com/v1/images/edits with the product photos as references. Shots: POST https://lovelyrouter.com/v1/videos/shots (`consent: true`; read the model licence in the docs and tell me if my use or region might not be allowed). Voiceover: POST https://lovelyrouter.com/v1/audio/speech. Join with POST https://lovelyrouter.com/v1/videos/joins.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the product photos, the presenter, the script and the languages>
01

仕組み

010203
  1. スタジオなしで商品を撮る

    商品の写真を参照画像として POST /v1/images/edits に送り、シーンを描写します。洗面所の棚の上、ジムバッグの中、窓辺で手に持ったところなど。n で1リクエストにつき最大10バージョンを、画像1枚あたりの定額で依頼できます。

  2. 出演者をキャスティングする

    画像APIで出演者のターンアラウンドシート(三面図)を描き、キャラクターとして無料で保存します。キャラクターに声を与えます。qwen3-tts で説明から声をデザインして保存するか、自分自身の、あるいは使用許可を得た声をアップロードします。

  3. 台詞をショットとして撮る

    各クリップはショットです。POST /v1/videos/shots に、出演者をタグ付け(@Jess)し、台詞を二重引用符で囲んだプロンプトを送ります。ショットは映像、音声、そしてキャラクターの声で話された台詞とともに返ります。商品から始めたい場合は、フレームをシーンとして送り、そのフレームからショットが始まると指定します。

  4. カットをつなぐ

    POST /v1/videos/joins は、同じサイズの完成したショットを最大50本、それぞれの音声ごと、順番に無料でつなぎます。その後に加えるもの(字幕、音楽、ロゴのエンドカード)は、自分のエディタで行います。

02

リクエスト

まずは商品カットから。OpenAI SDKの向き先を https://lovelyrouter.com/v1 にします:

Python
import base64
import os
from openai import OpenAI

client = OpenAI(base_url="https://lovelyrouter.com/v1", api_key=os.environ["LOVELY_API_KEY"])

result = client.images.edit(
    model="gpt-image-2.5-flare",
    image=[open("serum.png", "rb")],
    prompt="The serum bottle from the image on a sunlit bathroom shelf next to a folded towel, phone-camera look, vertical",
    size="1024x1536",
    n=4,
)
for i, image in enumerate(result.data):
    with open(f"serum-{i + 1}.png", "wb") as f:
        f.write(base64.b64decode(image.b64_json))

次にショット。出演者は保存済みのキャラクターで、冒頭フレーム(たとえば、商品カットの1枚を、出演者のシートを2枚目の参照画像として編集したもの)をシーンとして送ります。

cURL
curl "https://lovelyrouter.com/v1/videos/shots?wait=300" \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "minimax-h3-video",
    "consent": true,
    "size": "9:16",
    "seconds": 10,
    "prompt": "The shot opens exactly on @[Opening frame] as its first frame. @Jess picks up the bottle, holds it to the camera and says: \"Okay, this is the one I keep telling you about.\"",
    "characters": ["chr_3b9e1f0c7a2d4e58b6c1a9f2"],
    "scenes": [{"name": "Opening frame", "image": "https://example.com/jess-with-serum.png"}]
  }'

残りの台詞も同じように作り、POST /v1/videos/joins と {"shots": ["shot_…", "shot_…", "shot_…"]} でつなぎます。ポーリング、タグ、エラーについては動画ショットのリファレンスを参照してください。

03

どのAPIがどのパーツを作るか

広告のパーツ作成元備考
商品カットと冒頭フレーム画像API: gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst編集1回につき参照画像は最大16枚、n は最大10、最大3840×2160
出演者の見た目画像APIのターンアラウンドシートを POST /v1/characters(sheet_image_job)で保存保存は無料、アカウントあたり最大100
出演者の声qwen3-tts でデザインした声を POST /v1/audio/voices で保存、または同意付きでアップロードしたサンプルキャラクターに voice_id として紐付け
トーキングクリップminimax-h3-video を使った動画ショット各5〜15秒、9:16、16:9、1:1、音声と台詞を含む
自分の映像に出演者を入れるmode: "face" を使ったキャラクター置換一度撮影し、市場ごとに出演者の頭部を差し替え。手、服、商品は撮影どおり
別撮りのナレーションテキスト読み上げ音声ファイル。動画へのミックスは自分で行う
最終カットPOST /v1/videos/joins、無料ショットを順番につなぐ。字幕、音楽、オーバーレイはなし
04

あなたがやること

{}
台本と訴求を書く。

ショットは引用符に入れた言葉をそのまま話します。広告で何を約束するかはあなたの責任です。

商品を確認する。

生成された画像やショットは細部を変えることがあります。ラベルの文字、キャップ、液体の色など。公開前にすべてのフレームを実物と見比べ、ずれたものは再生成してください。

編集と字幕。

ジョインはショット自身の音声を持つ1本のmp4を返します。字幕、音楽、ナレーションのミックス、ロゴ、エンドカードはエディタか自前のffmpegステップで行います。

開示する。

広告を出す場所ではどこでも、出演者がAI生成であると明記し、広告プラットフォームのルールに従い、生成された出演者を実在の顧客や本物のレビューとして提示しないでください。

使える場所を確認する。

動画モデルはMiniMax H3の規約に従い、すべてのリクエストが consent: true でこれを承諾します。EU、英国、韓国、米国では使用できません。

05

レシピ

昼前に20の商品アングル。

カタログをループし、各商品写真を3つのシーンプロンプトと n: 4 で送ります。画像ジョブとして送れば、接続を開いたままにしません。

どの広告でも同じ出演者。

出演者は一度保存して character_id を使い回します。キャンペーン全体で同じ顔、同じ服、同じ声。

1つの台本を3言語で。

各ショットに language(en、zh、ja など)を送り、台詞は引用符の中で翻訳します。

本物のデモを、多くの出演者で。

商品デモは自分で撮影し、市場ごとにキャラクター置換で出演者の頭部を差し替えます。手と商品は撮影したままです。

テスト用のフック。

冒頭の台詞を変えた5秒のオープニングショットをいくつかレンダリングし、それぞれを同じ本編につないで、別々の広告としてテストします。

06

料金

パーツ価格
商品カット、シート、フレーム画像1枚あたり $0.04、サイズ不問、生成も編集も同じ
動画ショット画像1枚のレンダリング1秒あたり $0.13、追加の画像1枚ごとに1秒あたり $0.06
ジョイン、保存したキャラクター、保存した声無料
声のデザインとナレーション音声1分あたり $0.036
キャラクター置換置換1秒あたり $0.2

10秒のショット3本(各ショットに出演者と冒頭フレーム=画像2枚)で作る30秒の広告は、1ショットあたり10.13秒をレンダリングし、動画に約 $5.77、加えて画像数枚を1枚 $0.04 で要します。ショットに2人以上のキャラクターが登場する場合、短いチャット呼び出しがプロンプト内で全員を指名し、通常のチャットリクエストとして課金されます。ショットは送信時に前払い残高から予約され、完了時に課金されます。失敗したショットは無料です。すべての価格は料金ページにあります。

07

よくある質問

?
広告全体は1回の呼び出しで生成されますか?+

いいえ。各パーツは個別のリクエストです。商品カットには画像、各クリップにはショット、カットにはジョイン。これにより各ステップを確認でき、外したパーツだけを再生成できます。

出演者は実際に話しますか?+

はい。ショットのプロンプトで二重引用符に入れた言葉は、その直前にタグ付けされたキャラクターが話します。保存された声があればその声で、音は動画モデルが生成します。

商品は実物とまったく同じに見えますか?+

近くなりますが、確認してください。参照画像は形状と色をよく保ちますが、小さな文字や細部は変わることがあります。すべてのフレームを実物と比較し、ずれたものは再生成してください。

生成した出演者の代わりに自分の映像を使えますか?+

はい。広告を自分で撮影し、キャラクター置換で人物全体または頭部だけを差し替えます。動き、カメラ、カット、音はそのままです。

APIで音楽や字幕を追加できますか?+

いいえ。ジョインはショットをそれぞれの音声ごとつなぐだけです。音楽、字幕、オーバーレイ、別撮りのナレーションはエディタで追加します。

これらの広告はどこで配信できますか?+

広告プラットフォームのルールとモデルの規約に従ってください。MiniMax H3の規約ではEU、英国、韓国、米国での使用が認められておらず、生成された出演者はすべてAIであると開示すべきです。

AIエージェントがこのパイプラインを構築できますか?+

はい。このページのプロンプトをClaude Code、Cursor、Codexに貼り付けてください。Markdownのドキュメントを読み、あなたのキーで画像、ショット、ジョインの呼び出しを書きます。

静止画の商品撮影だけならAI商品写真をご覧ください。まずショットを試すには動画プレイグラウンドを開くか、アカウントを作成してキーを取得してください。

モデル・データ・エージェントを 1 つのプリペイドキーで

サブスクリプションなし。チャージして必要な分だけ使い、すべての請求をログで確認できます。