ブラックフライデーチャージボーナス
対象のチャージごとに無料クレジットが付き、他の特典とも併用できます。
11月30日まで
物語には、どのショットにも同じ人物が出ている必要があります。POST /v1/videos/shots では、何が起きるかを書き、キャストと場所をタグ付けします。@Leo looks up as @Mia_Wong sits down in @[Night Café]: "You came." のように書くと、タグ付けされたキャラクターとシーンがそれぞれ参照画像になります。人物は画像から顔、髪、服装を保ち、場所はその見た目を保ち、ショットには独自の音声と話されるセリフが付きます。物語をショットごとにレンダリングし、その後ショットを無料で1本の動画に結合できます。モデルは minimax-h3-video で、MiniMax H3 を採用しており、画像1枚でレンダリング秒あたり $0.13、追加の画像1枚ごとに秒あたり $0.06 です。
AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Make multi-character video shots with the Lovely Router video shots API and join them into one film. - Docs (read first): https://lovelyrouter.com/docs/api/video-shots.md and https://lovelyrouter.com/docs/api/characters.md - Save characters and scenes once (POST https://lovelyrouter.com/v1/characters, /v1/scenes), then POST https://lovelyrouter.com/v1/videos/shots with a prompt that tags them (`@handle`), `consent: true`; poll the shot until it is completed. Join finished shots with POST https://lovelyrouter.com/v1/videos/joins (free). - Billed per rendered second plus a fee per extra picture; render one short test shot before a whole episode. - 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 scenes and the shot list>
プロンプトは脚本のように書く
プロンプトが画像を選びます。タグ付けされたキャラクターとシーンは、最初に言及された順に、1ショットあたり1〜9枚の画像になります。
| 書く内容 | 意味 |
|---|---|
@Mia_Wong | Mia Wong という名前のキャラクター。スペースは _ になり、大文字小文字は区別されません |
@[Night Café] | 書いたとおりの任意の名前 |
@chr_… または @scn_… | id によるキャラクターまたはシーン。同じ名前が2つある場合に使います |
"You came." | セリフ。直前でタグ付けされたキャラクターが話します |
顔や服装は描写しないでください。それらは画像が担います。代わりにアクション、カメラ、雰囲気に言葉を使ってください。タグのないプロンプトは、リストに挙げたキャラクターとシーンがそれぞれ1つだけのとき、それを使います。
MiniMax H3 は 6 セクションの長いプロンプトを最もよく読み取りますが、それを書く必要はありません。レンダリングのたびに、ビジョンモデル(rewrite_model、デフォルトは gemini-4-argon)が画像と依頼を読んで H3 プロンプト全体を書きます。prompt_rendered でモデルが受け取った内容を確認でき、rewrite: false を指定すると自分のプロンプトが送られます。自分で書きたい場合は MiniMax H3 プロンプトの書き方 で形式を解説しています。
代名詞は誰が誰か分からなくなるよくある原因なので、ショットのレンダリング前に、セリフ以外の代名詞はタグに置き換えられます。キャラクターが1人の場合は即座に無料で行われます。2人以上の場合はチャットモデル(sweep_model、デフォルトは gemini-3.8-flash)がプロンプトを書き換え、結果が同じタグと同じセリフを一言一句保っているか確認されます。その呼び出しは通常のチャットとして課金され、other_usd として表示されます。レンダリングされたテキストは prompt_rendered にあり、sweep: false を指定するとプロンプトは書いたとおりに保たれます。
キャストから完成動画まで
キャストと場所を保存する
保存済みキャラクターとは、名前、説明、ターンアラウンドシートです。同じ人物を4方向から、6つの表情のクローズアップの上に並べたものです。シートは画像 API で作成し、画像ジョブから
sheet_image_jobで直接保存します。シーンは場所とその画像です。どちらも無料で、アカウントごとにそれぞれ100件までです。cURLcurl https://lovelyrouter.com/v1/characters \ -H "Authorization: Bearer $LOVELY_API_KEY" \ -F name="Mia Wong" \ -F description="A woman in her twenties with a short black bob and a yellow raincoat" \ -F sheet=@mia-sheet.png curl https://lovelyrouter.com/v1/scenes \ -H "Authorization: Bearer $LOVELY_API_KEY" \ -F name="Night Café" \ -F description="A narrow café at night, neon in the rain-streaked window" \ -F image=@cafe.pngショットをレンダリングする
ショットが使えるキャラクターとシーンを列挙し(ライブラリ全体でも構いません)、その中で使うものにタグを付けます。ショットは5〜15秒で、
16:9、9:16、1:1のいずれかです。Pythonimport os, requests API = "https://lovelyrouter.com/v1/videos" H = {"Authorization": f"Bearer {os.environ['LOVELY_API_KEY']}"} shot = requests.post(f"{API}/shots", headers=H, params={"wait": 300}, json={ "model": "minimax-h3-video", "consent": True, "prompt": "In @[Night Café], @Leo looks up as @Mia_Wong sits down: \"You came.\"", "characters": ["chr_3b9e1f0c7a2d4e58b6c1a9f2", "chr_1e4b7d0a9c3f2e5b8a6d0c1f"], "scenes": ["scn_5b2d9e0c1a7f4b3e8d6c2a1f"], "seconds": 5, "style": "warm 35mm film", }).json() print(shot["status"], shot["rendered_seconds"], shot["url"])ショットを結合する
同じサイズの完成したショットを2〜50本、再生順に結合します。それぞれに独自の音声が付きます。結合は無料です。
Node.jsconst res = await fetch('https://lovelyrouter.com/v1/videos/joins', { method: 'POST', headers: { Authorization: `Bearer ${process.env.LOVELY_API_KEY}`, 'content-type': 'application/json' }, body: JSON.stringify({ shots: ['shot_8c1f0a7d3b9e4c2a6f5d1e0b', 'shot_0d2e4f6a8b1c3e5d7f9a0b2c'] }), }); const join = await res.json(); console.log(join.id, join.status);
POST /v1/videos/shots はショットオブジェクトとともに 202 を返します。wait(最大300秒)以内にショットが完了した場合は 200 を返します。それ以外は GET /v1/videos/shots/{id}?wait=60 でポーリングし、mp4 を /content からダウンロードしてください。完成したファイルは7日間保持されます。
手持ちの画像から始める
特定のフレームからショットを始めるには、その画像をシーンとして送り、プロンプトでそう指定します:「ショットは @[Opening frame] からその最初のフレームとして正確に始まる。@Priya が窓から振り向き、カメラに向かって歩く。」 冒頭はその画像にかなり忠実に従いますが、ピクセル単位ではありません。フレーム内の人物はそこから引き継がれません。同じ見た目にしたい場合はキャラクターとしても送ってください。そのフレームは料金上1枚の画像として数えられます。
絵コンテ用のプロジェクト
プロジェクトは絵コンテを保持します。名前と独自の JSON ドキュメント(最大200 KB)で、project_id を使ってショットや結合をそこに紐付けられます。プレイグラウンド はサイズ、スタイル、言語、ショット、キャラクター、シーンを1つに保存します。プロジェクトは無料で、アカウントごとに100件までです。
curl https://lovelyrouter.com/v1/videos/projects \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{"name": "Night café", "doc": {"size": "16:9", "shots": []}}'料金
ショットはレンダリングされた秒単位で課金されます。モデルは24 fps の固定フレームグリッドでレンダリングするため、5秒のショットは5.17秒、10秒のショットは10.13秒としてレンダリングされます。どちらになるかはショットオブジェクトの rendered_seconds に示されます。
| ショット内の画像数 | レンダリング秒あたり |
|---|---|
| 1 | $0.13 |
| 追加の画像1枚ごと | + $0.06 |
| 3(キャラクター2人とシーン) | $0.25 |
したがって上記のカフェのショット、キャラクター2人とシーン付きの5秒は約 $1.29 かかります。料金は送信時に確保され、ショットの完了時に請求されます。失敗したショットとキャンセルしたショットは無料で、結合、プロジェクト、保存済みのキャラクターとシーンも無料です。2人以上のキャラクターがショットにいる場合のプロンプトスイープのチャット呼び出しは、同じキーでチャットとして課金されます。その他は料金をご覧ください。
| モデル | 入力 → 出力 | 価格 |
|---|---|---|
| MiniMax H3 Video (FastH3 Omni) minimax-h3-video | text+image→video | 1 秒 $0.13 |
米ドルのリアルタイム価格。API の請求額と同じです。
ショットは MiniMax H3 の規約 に従います。すべてのリクエストで consent: true を設定します。各アカウントでは同時に5件のショットまたは結合をキューに入れるかレンダリングできます。
よくある質問
1つのショットに何人のキャラクターを入れられますか?+
1ショットあたり最大9枚の画像で、キャラクターとシーンを合算します。声付きのキャラクターは最大3人まで自分の声を持ち込み、残りはモデルが声を当てます。
ショットの長さはどれくらいですか?+
5〜15秒です。完成した同じサイズのショットを最大50本まで、1本の長い動画に無料で結合できます。
ショットに音声は付きますか?+
はい。すべてのショットには独自の音声と、二重引用符で囲んだセリフが付き、セリフは直前にタグ付けされたキャラクターが、設定した language(デフォルトは英語)で話します。
動画ショットの料金はいくらですか?+
画像1枚でレンダリング秒あたり $0.13、追加の画像1枚ごとに秒あたり $0.06 です。結合は無料で、失敗したショットは無料です。
先にキャラクターを保存する必要はありますか?+
いいえ。ショットはインラインのキャラクターとシーン、{name, image} を http(s) または data: URL で受け付けます。保存しておけば毎回画像を送らずに済みます。
キャラクタースワップとの違いは何ですか?+
キャラクタースワップは、すでにあるクリップに新しい人物を入れます。ショットはプロンプトと画像から動画をゼロから作ります。既存の動画のキャストを入れ替えるにはキャラクター置き換えをご覧ください。
すべてのフィールドとエラーコードは動画ショットのリファレンスにあります。視聴中も流れ続けるストリームについてはライブ動画 APIをご覧ください。