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

AIショートドラマ生成:
キャスト、セット、1話をAPIから

コードから縦型ショートドラマを制作。キャストとセットを一度保存し、各ショットを@タグと引用符付きセリフで書き、無料で結合して1話に仕上げます。

最終更新日 2026-11-05

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで
shots$ curl https://lovelyrouter.com/v1/videos/shots -H "Authorization: …> @mia hands @leo the letter in @kitchen. "You kept it?" shot rendering · 5 s · 2 characters ⏺ POST /v1/videos/joins [shot_1, shot_2, shot_3] ✓ episode.mp4 ready
ブラックフライデー

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

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

11月30日まで

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

ショートドラマは、同じ顔ぶれ、同じ部屋、そして数秒ごとのセリフで、何話も続いていきます。ビデオショットは、まさにそのために作られています。キャストはキャラクターとして一度保存し(ターンアラウンドシートと声をそれぞれ)、セットはシーンとして保存します。各ショットは、誰がどこにいるかをタグ付けした一文として書きます。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>
01

仕組み

010203
  1. シリーズのキャストを揃える

    主要人物はそれぞれ画像生成APIでターンアラウンドシートとして描き、POST /v1/characters で無料で保存します。それぞれに声を紐付けます。テキスト読み上げで設計した声か、同意を得た演者の録音です。

  2. セットを組む

    繰り返し登場する場所——オフィス、ペントハウス、病院の廊下——は POST /v1/scenes で保存します。名前、説明、画像です。1アカウントにつきシーン100件、キャラクター100件までです。

  3. ショットを書く

    1ショットにつき1リクエスト。キャラクターとシーンをタグ付けしたプロンプトに、セリフを二重引用符で書きます。タグ付けされたものはそれぞれ参照画像になるので、顔、髪、服、部屋はプロンプトではなくライブラリから来ます。ショットは5〜15秒です。

  4. エピソードを編集する

    POST /v1/videos/joins は、同じサイズの完成済みショットを最大50本、順番に、それぞれの音を保ったまま無料でつなぎます。エピソードのショットリスト、キャラクター、シーンはプロジェクトに保存して、後から戻れるようにしましょう。

02

数回のリクエストで1話

Python
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で掲載しています。

03

作業に使うツール

保存済みキャラクター。

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 を指定するとショットを再現可能にできます。

04

うまくいくショットの書き方

{}
毎回、全員にタグを付ける。

画像が顔と服を担うので、プロンプトには起きることだけを書きます。キャラクターの見た目は描写せず、行動を描写します。

1ショットに1つのビート。

セリフ1行とアクション1つが5〜8秒のショットに収まります。長いセリフは2つのショットに分けたほうが自然です。

必要なときはフレームから始める。

一致させる必要のあるカットでは、そのフレームをシーンとして送り、The shot opens exactly on @[Opening frame] as its first frame. と書きます。冒頭はそれにかなり忠実に従いますが、ピクセル単位ではありません。

衣装は意図的に変える。

新しい衣装は新しいシートです。PATCH /v1/characters/{id} でキャラクターを更新するか、その衣装を独立したキャラクターとして保存します。作成済みの動画は使用したシートを保ちます。

チャットモデルに脚本の下書きを任せる。

キーで使える任意のチャットモデルが、あらすじをこの形式の番号付きショットリストに変換できます。レンダリング前にレビューしてください。

05

料金

ショットはレンダリングされた秒数で課金されます。画像1枚で $0.13、追加画像1枚につき毎秒 $0.06 が加算されます。モデルは固定のフレームグリッドでレンダリングするため、5秒のショットは5.17秒、10秒のショットは10.13秒として課金されます。10秒のショット6本(各2キャラクターと1シーン、画像3枚)からなる1分のエピソードは約 $15.20 です。スイープのチャット呼び出しは、同じキーの通常のチャットリクエストとして課金されます。キャラクター、シーン、声、プロジェクト、結合は無料です。各ショットは送信時に前払い残高から予約され、完了時に課金されます。失敗・キャンセルしたショットは無料です。シートとフレームは画像1枚につき $0.04 です。すべての価格は料金に掲載されています。

06

規約と責任ある利用

minimax-h3-video は MiniMax H3規約の対象です。各ショットで consent: true を設定して同意します。EU、英国、韓国、米国でモデルを使用しないことを含みます。所有している、または使用許可のある顔と声を使用してください。実在の人物に基づくキャストには本人の同意が必要です。利用規約(AUP)が適用されます。完成したショットと結合は7日間保持されるので、エピソードは完成したらダウンロードしてください。

07

よくある質問

?
キャラクターはどのショットでも同じ見た目になりますか+

はい、それがタグ付けの狙いです。タグ付けされた各キャラクターのターンアラウンドシートがショットの参照画像になるので、顔、髪、服は毎回そこから来ます。プロンプトで見た目を描写しないでください。

キャラクターは話せますか+

はい。キャラクターのタグの後にセリフを二重引用符で置くと、動画モデルが生成する音とともにショット内で話されます。保存済みの声を持つキャラクターはその声で話します。

ショットはどれくらいの長さにできますか+

5〜15秒です。エピソードは最大50本のショットの結合で、すべて同じサイズ、7日未満のものです。

中国語や日本語でドラマを作れますか+

はい。language を zh、ja などのコードに設定し、セリフをその言語で書きます。タグはどんな名前でも機能します。

エピソードを作り直さずに1つのショットを編集できますか+

はい。そのショットの新しいバージョンをレンダリングし、新しいIDをその位置に入れてショットリストを再度結合します。結合は無料です。

絵コンテツールはありますか+

プレイグラウンドは絵コンテをプロジェクトとして保持し、コードからも POST /v1/videos/projects と独自のJSONで同じことができます。

AIエージェントにエピソードを制作させられますか+

はい。このページのプロンプトをClaude Code、Cursor、Codexに貼り付けてください。エージェントはMarkdownドキュメントを読み、ショットリストを下書きし、あなたのキーでショットと結合を作成します。

同じキャラクターで歌手のミュージックビデオを作るならミュージックビデオ、手持ちの映像にキャストを入れるならキャラクター置き換えを参照するか、サインアップしてキーを取得してください。

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

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