ブラックフライデーチャージボーナス
対象のチャージごとに無料クレジットが付き、他の特典とも併用できます。
11月30日まで
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>
仕組み
スタジオなしで商品を撮る
商品の写真を参照画像として
POST /v1/images/editsに送り、シーンを描写します。洗面所の棚の上、ジムバッグの中、窓辺で手に持ったところなど。nで1リクエストにつき最大10バージョンを、画像1枚あたりの定額で依頼できます。出演者をキャスティングする
画像APIで出演者のターンアラウンドシート(三面図)を描き、キャラクターとして無料で保存します。キャラクターに声を与えます。
qwen3-ttsで説明から声をデザインして保存するか、自分自身の、あるいは使用許可を得た声をアップロードします。台詞をショットとして撮る
各クリップはショットです。
POST /v1/videos/shotsに、出演者をタグ付け(@Jess)し、台詞を二重引用符で囲んだプロンプトを送ります。ショットは映像、音声、そしてキャラクターの声で話された台詞とともに返ります。商品から始めたい場合は、フレームをシーンとして送り、そのフレームからショットが始まると指定します。カットをつなぐ
POST /v1/videos/joinsは、同じサイズの完成したショットを最大50本、それぞれの音声ごと、順番に無料でつなぎます。その後に加えるもの(字幕、音楽、ロゴのエンドカード)は、自分のエディタで行います。
リクエスト
まずは商品カットから。OpenAI SDKの向き先を https://lovelyrouter.com/v1 にします:
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 "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_…"]} でつなぎます。ポーリング、タグ、エラーについては動画ショットのリファレンスを参照してください。
どの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、無料 | ショットを順番につなぐ。字幕、音楽、オーバーレイはなし |
あなたがやること
ショットは引用符に入れた言葉をそのまま話します。広告で何を約束するかはあなたの責任です。
生成された画像やショットは細部を変えることがあります。ラベルの文字、キャップ、液体の色など。公開前にすべてのフレームを実物と見比べ、ずれたものは再生成してください。
ジョインはショット自身の音声を持つ1本のmp4を返します。字幕、音楽、ナレーションのミックス、ロゴ、エンドカードはエディタか自前のffmpegステップで行います。
広告を出す場所ではどこでも、出演者がAI生成であると明記し、広告プラットフォームのルールに従い、生成された出演者を実在の顧客や本物のレビューとして提示しないでください。
動画モデルはMiniMax H3の規約に従い、すべてのリクエストが consent: true でこれを承諾します。EU、英国、韓国、米国では使用できません。
レシピ
カタログをループし、各商品写真を3つのシーンプロンプトと n: 4 で送ります。画像ジョブとして送れば、接続を開いたままにしません。
出演者は一度保存して character_id を使い回します。キャンペーン全体で同じ顔、同じ服、同じ声。
各ショットに language(en、zh、ja など)を送り、台詞は引用符の中で翻訳します。
商品デモは自分で撮影し、市場ごとにキャラクター置換で出演者の頭部を差し替えます。手と商品は撮影したままです。
冒頭の台詞を変えた5秒のオープニングショットをいくつかレンダリングし、それぞれを同じ本編につないで、別々の広告としてテストします。
料金
| パーツ | 価格 |
|---|---|
| 商品カット、シート、フレーム | 画像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人以上のキャラクターが登場する場合、短いチャット呼び出しがプロンプト内で全員を指名し、通常のチャットリクエストとして課金されます。ショットは送信時に前払い残高から予約され、完了時に課金されます。失敗したショットは無料です。すべての価格は料金ページにあります。
よくある質問
広告全体は1回の呼び出しで生成されますか?+
いいえ。各パーツは個別のリクエストです。商品カットには画像、各クリップにはショット、カットにはジョイン。これにより各ステップを確認でき、外したパーツだけを再生成できます。
出演者は実際に話しますか?+
はい。ショットのプロンプトで二重引用符に入れた言葉は、その直前にタグ付けされたキャラクターが話します。保存された声があればその声で、音は動画モデルが生成します。
商品は実物とまったく同じに見えますか?+
近くなりますが、確認してください。参照画像は形状と色をよく保ちますが、小さな文字や細部は変わることがあります。すべてのフレームを実物と比較し、ずれたものは再生成してください。
生成した出演者の代わりに自分の映像を使えますか?+
はい。広告を自分で撮影し、キャラクター置換で人物全体または頭部だけを差し替えます。動き、カメラ、カット、音はそのままです。
APIで音楽や字幕を追加できますか?+
いいえ。ジョインはショットをそれぞれの音声ごとつなぐだけです。音楽、字幕、オーバーレイ、別撮りのナレーションはエディタで追加します。
これらの広告はどこで配信できますか?+
広告プラットフォームのルールとモデルの規約に従ってください。MiniMax H3の規約ではEU、英国、韓国、米国での使用が認められておらず、生成された出演者はすべてAIであると開示すべきです。
AIエージェントがこのパイプラインを構築できますか?+
はい。このページのプロンプトをClaude Code、Cursor、Codexに貼り付けてください。Markdownのドキュメントを読み、あなたのキーで画像、ショット、ジョインの呼び出しを書きます。
静止画の商品撮影だけならAI商品写真をご覧ください。まずショットを試すには動画プレイグラウンドを開くか、アカウントを作成してキーを取得してください。