ブラックフライデーチャージボーナス
対象のチャージごとに無料クレジットが付き、他の特典とも併用できます。
11月30日まで
ショートドラマは、同じ顔ぶれ、同じ部屋、そして数秒ごとのセリフで、何話も続いていきます。ビデオショットは、まさにそのために作られています。キャストはキャラクターとして一度保存し(ターンアラウンドシートと声をそれぞれ)、セットはシーンとして保存します。各ショットは、誰がどこにいるかをタグ付けした一文として書きます。In @[Penthouse], @Lena slaps the contract on the table: "You lied to me." そうすれば、ショットはその顔ぶれ、その部屋、音、そしてLenaの声で話されるセリフとともに返ってきます。完成したショットは無料で結合して1話にでき、絵コンテはプロジェクトに保存できます。ショート動画アプリ向けには縦型の 9:16、それ以外には 16:9。ビデオプレイグラウンドならコードは不要です。
AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Build a tool that turns a short drama script into vertical episodes with Lovely Router saved characters, scenes, video shots and free joins. - Docs (read first): https://lovelyrouter.com/docs/api/video-shots.md and https://lovelyrouter.com/docs/api/characters.md - Save the cast and sets (POST https://lovelyrouter.com/v1/characters, /v1/scenes), write each shot with `@handle` tags and quoted dialogue to POST https://lovelyrouter.com/v1/videos/shots (`consent: true`), poll, then 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 cast, the sets and the episode script>
仕組み
シリーズのキャストを揃える
セットを組む
繰り返し登場する場所——オフィス、ペントハウス、病院の廊下——は
POST /v1/scenesで保存します。名前、説明、画像です。1アカウントにつきシーン100件、キャラクター100件までです。ショットを書く
1ショットにつき1リクエスト。キャラクターとシーンをタグ付けしたプロンプトに、セリフを二重引用符で書きます。タグ付けされたものはそれぞれ参照画像になるので、顔、髪、服、部屋はプロンプトではなくライブラリから来ます。ショットは5〜15秒です。
エピソードを編集する
POST /v1/videos/joinsは、同じサイズの完成済みショットを最大50本、順番に、それぞれの音を保ったまま無料でつなぎます。エピソードのショットリスト、キャラクター、シーンはプロジェクトに保存して、後から戻れるようにしましょう。
数回のリクエストで1話
import os
import requests
BASE = "https://lovelyrouter.com/v1"
H = {"Authorization": f"Bearer {os.environ['LOVELY_API_KEY']}"}
LENA = "chr_3b9e1f0c7a2d4e58b6c1a9f2" # saved with POST /v1/characters
MARCUS = "chr_1e4b7d0a9c3f2e5b8a6d0c1f"
PENTHOUSE = "scn_5b2d9e0c1a7f4b3e8d6c2a1f" # saved with POST /v1/scenes
project = requests.post(f"{BASE}/videos/projects", headers=H,
json={"name": "The Contract, episode 3", "doc": {"size": "9:16"}}).json()
script = [
'In @[Penthouse], @Lena storms in and slaps the contract on the table: "You lied to me."',
'@Marcus looks up from the window, calm: "I protected you."',
'@Lena laughs once, without humour, and steps closer to @Marcus: "From what?"',
]
shot_ids = []
for line in script:
shot = requests.post(f"{BASE}/videos/shots?wait=300", headers=H, json={
"model": "minimax-h3-video",
"consent": True,
"prompt": line,
"characters": [LENA, MARCUS],
"scenes": [PENTHOUSE],
"size": "9:16",
"seconds": 8,
"project_id": project["id"],
}).json()
while shot["status"] in ("queued", "in_progress"):
shot = requests.get(f"{BASE}/videos/shots/{shot['id']}?wait=120", headers=H).json()
shot_ids.append(shot["id"])
episode = requests.post(f"{BASE}/videos/joins", headers=H,
json={"shots": shot_ids, "project_id": project["id"]}).json()
print(episode["id"], episode["status"])結合が完了したら、GET /v1/videos/joins/{id}/content からダウンロードします。ここでは分かりやすさのために1本ずつ作成していますが、1アカウントで同時に5本のショットまたは結合をキューに入れたりレンダリングしたりできるので、待つ前に複数送ることもできます。ビデオショットのリファレンスには、同じ呼び出しをcURLとNode.jsで掲載しています。
作業に使うツール
POST /v1/characters には名前、説明、ターンアラウンドシート(正面、斜め前、側面、背面、6つの表情)を渡します。生成したシートは画像ジョブIDを sheet_image_job に指定して保存します。キャラクターを参照してください。
声を紐付けたキャラクターは、その声でセリフを話します。サンプルの音色、ピッチ、話し方です。ショット内で声を持つ最初の3キャラクターまでが声を反映し、声による価格の変動はありません。
POST /v1/scenes には場所とその画像を渡し、キャラクターと同じようにタグ付けします(@[Night Café])。
@Lena、@[Full Name]、またはID。二重引用符で囲んだ言葉は、その直前で最後にタグ付けされたキャラクターが話します。1ショットにつき画像は1〜9枚です。
キャラクターが2人以上いると、チャットモデルがセリフ以外の he、she、they をタグに書き換えるので、動画モデルは誰が何をするか分かります。セリフは変更されません。プロンプトを書いたとおりにレンダリングするには sweep: false を送ります。
結合は無料で、各ショットの音を保ちます。プロジェクトには独自のJSON絵コンテを最大200KBまで無料で保存でき、1アカウント100件までです。
language はセリフを話す言語(en、zh、ja など)を設定し、style はルック(warm 35mm film など)を設定します。seed を指定するとショットを再現可能にできます。
うまくいくショットの書き方
画像が顔と服を担うので、プロンプトには起きることだけを書きます。キャラクターの見た目は描写せず、行動を描写します。
セリフ1行とアクション1つが5〜8秒のショットに収まります。長いセリフは2つのショットに分けたほうが自然です。
一致させる必要のあるカットでは、そのフレームをシーンとして送り、The shot opens exactly on @[Opening frame] as its first frame. と書きます。冒頭はそれにかなり忠実に従いますが、ピクセル単位ではありません。
新しい衣装は新しいシートです。PATCH /v1/characters/{id} でキャラクターを更新するか、その衣装を独立したキャラクターとして保存します。作成済みの動画は使用したシートを保ちます。
キーで使える任意のチャットモデルが、あらすじをこの形式の番号付きショットリストに変換できます。レンダリング前にレビューしてください。
料金
ショットはレンダリングされた秒数で課金されます。画像1枚で $0.13、追加画像1枚につき毎秒 $0.06 が加算されます。モデルは固定のフレームグリッドでレンダリングするため、5秒のショットは5.17秒、10秒のショットは10.13秒として課金されます。10秒のショット6本(各2キャラクターと1シーン、画像3枚)からなる1分のエピソードは約 $15.20 です。スイープのチャット呼び出しは、同じキーの通常のチャットリクエストとして課金されます。キャラクター、シーン、声、プロジェクト、結合は無料です。各ショットは送信時に前払い残高から予約され、完了時に課金されます。失敗・キャンセルしたショットは無料です。シートとフレームは画像1枚につき $0.04 です。すべての価格は料金に掲載されています。
規約と責任ある利用
minimax-h3-video は MiniMax H3規約の対象です。各ショットで consent: true を設定して同意します。EU、英国、韓国、米国でモデルを使用しないことを含みます。所有している、または使用許可のある顔と声を使用してください。実在の人物に基づくキャストには本人の同意が必要です。利用規約(AUP)が適用されます。完成したショットと結合は7日間保持されるので、エピソードは完成したらダウンロードしてください。
よくある質問
キャラクターはどのショットでも同じ見た目になりますか+
はい、それがタグ付けの狙いです。タグ付けされた各キャラクターのターンアラウンドシートがショットの参照画像になるので、顔、髪、服は毎回そこから来ます。プロンプトで見た目を描写しないでください。
キャラクターは話せますか+
はい。キャラクターのタグの後にセリフを二重引用符で置くと、動画モデルが生成する音とともにショット内で話されます。保存済みの声を持つキャラクターはその声で話します。
ショットはどれくらいの長さにできますか+
5〜15秒です。エピソードは最大50本のショットの結合で、すべて同じサイズ、7日未満のものです。
中国語や日本語でドラマを作れますか+
はい。language を zh、ja などのコードに設定し、セリフをその言語で書きます。タグはどんな名前でも機能します。
エピソードを作り直さずに1つのショットを編集できますか+
はい。そのショットの新しいバージョンをレンダリングし、新しいIDをその位置に入れてショットリストを再度結合します。結合は無料です。
絵コンテツールはありますか+
プレイグラウンドは絵コンテをプロジェクトとして保持し、コードからも POST /v1/videos/projects と独自のJSONで同じことができます。
AIエージェントにエピソードを制作させられますか+
はい。このページのプロンプトをClaude Code、Cursor、Codexに貼り付けてください。エージェントはMarkdownドキュメントを読み、ショットリストを下書きし、あなたのキーでショットと結合を作成します。
同じキャラクターで歌手のミュージックビデオを作るならミュージックビデオ、手持ちの映像にキャストを入れるならキャラクター置き換えを参照するか、サインアップしてキーを取得してください。