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

複数キャラクターのシーン向け動画ショット 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%ボーナス
登録して受け取る

物語には、どのショットにも同じ人物が出ている必要があります。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>
01

プロンプトは脚本のように書く

プロンプトが画像を選びます。タグ付けされたキャラクターとシーンは、最初に言及された順に、1ショットあたり1〜9枚の画像になります。

書く内容意味
@Mia_WongMia 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 を指定するとプロンプトは書いたとおりに保たれます。

02

キャストから完成動画まで

  1. キャストと場所を保存する

    保存済みキャラクターとは、名前、説明、ターンアラウンドシートです。同じ人物を4方向から、6つの表情のクローズアップの上に並べたものです。シートは画像 API で作成し、画像ジョブから sheet_image_job で直接保存します。シーンは場所とその画像です。どちらも無料で、アカウントごとにそれぞれ100件までです。

    cURL
    curl 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
  2. ショットをレンダリングする

    ショットが使えるキャラクターとシーンを列挙し(ライブラリ全体でも構いません)、その中で使うものにタグを付けます。ショットは5〜15秒で、16:9、9:16、1:1 のいずれかです。

    Python
    import 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"])
  3. ショットを結合する

    同じサイズの完成したショットを2〜50本、再生順に結合します。それぞれに独自の音声が付きます。結合は無料です。

    Node.js
    const 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日間保持されます。

03

自分の声で話すキャラクター

キャラクターに保存済みの声(voice_id)を割り当てるか、保存時にサンプルをアップロードすると、ショット内のそのキャラクターのセリフはその声で話されます。声の音色、ピッチ、話し方であり、言葉そのものではありません。ショットの最初の3人の声付きキャラクターが、画像の順に声を持ち込みます。それ以外はモデルが声を当てます。声は設計することもできます。テキスト読み上げ に説明を渡し、結果を保存してリンクしてください。声によって料金は変わりません。

04

手持ちの画像から始める

{}

特定のフレームからショットを始めるには、その画像をシーンとして送り、プロンプトでそう指定します:「ショットは @[Opening frame] からその最初のフレームとして正確に始まる。@Priya が窓から振り向き、カメラに向かって歩く。」 冒頭はその画像にかなり忠実に従いますが、ピクセル単位ではありません。フレーム内の人物はそこから引き継がれません。同じ見た目にしたい場合はキャラクターとしても送ってください。そのフレームは料金上1枚の画像として数えられます。

05

絵コンテ用のプロジェクト

プロジェクトは絵コンテを保持します。名前と独自の JSON ドキュメント(最大200 KB)で、project_id を使ってショットや結合をそこに紐付けられます。プレイグラウンド はサイズ、スタイル、言語、ショット、キャラクター、シーンを1つに保存します。プロジェクトは無料で、アカウントごとに100件までです。

cURL
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": []}}'
06

料金

ショットはレンダリングされた秒単位で課金されます。モデルは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→video1 秒 $0.13

米ドルのリアルタイム価格。API の請求額と同じです。

ショットは MiniMax H3 の規約 に従います。すべてのリクエストで consent: true を設定します。各アカウントでは同時に5件のショットまたは結合をキューに入れるかレンダリングできます。

07

よくある質問

?
1つのショットに何人のキャラクターを入れられますか?+

1ショットあたり最大9枚の画像で、キャラクターとシーンを合算します。声付きのキャラクターは最大3人まで自分の声を持ち込み、残りはモデルが声を当てます。

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

5〜15秒です。完成した同じサイズのショットを最大50本まで、1本の長い動画に無料で結合できます。

ショットに音声は付きますか?+

はい。すべてのショットには独自の音声と、二重引用符で囲んだセリフが付き、セリフは直前にタグ付けされたキャラクターが、設定した language(デフォルトは英語)で話します。

動画ショットの料金はいくらですか?+

画像1枚でレンダリング秒あたり $0.13、追加の画像1枚ごとに秒あたり $0.06 です。結合は無料で、失敗したショットは無料です。

先にキャラクターを保存する必要はありますか?+

いいえ。ショットはインラインのキャラクターとシーン、{name, image} を http(s) または data: URL で受け付けます。保存しておけば毎回画像を送らずに済みます。

キャラクタースワップとの違いは何ですか?+

キャラクタースワップは、すでにあるクリップに新しい人物を入れます。ショットはプロンプトと画像から動画をゼロから作ります。既存の動画のキャストを入れ替えるにはキャラクター置き換えをご覧ください。

すべてのフィールドとエラーコードは動画ショットのリファレンスにあります。視聴中も流れ続けるストリームについてはライブ動画 APIをご覧ください。

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

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