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

途切れないショットを配信するライブ動画API

POST /v1/videos/live は、音付きの約5秒の動画チャンクを連続して配信します。プロンプトやディレクターモデルで操作でき、課金は秒単位です。

最終更新日 2026-11-05

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで
live video$ curl -N https://lovelyrouter.com/v1/videos/live -d '{"model": "lt… event: session · event: chunk 0.mp4> POST …/prompt "she turns to the window" event: chunk 1.mp4 · event: chunk 2.mp4 ✓ streaming · steered live
ブラックフライデー

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

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

11月30日まで

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

ライブ動画はレンダリングが終わっても終わりません。POST /v1/videos/live はサーバー送信イベントのストリームを開き、数秒ごとに約5秒の新しいmp4チャンクを届けます。各チャンクは、動きも含めて前のチャンクの最後の1秒から続きます。そのため、続けて再生すると、独自の音を持つ1つの連続ショットになります。再生中に次に起きることを変えられます。新しいプロンプトを送るか、チャットモデルであるディレクターに次のショットを毎回書かせ、あなたの指示を受け取らせます。料金は生成した動画1秒あたり$0.019で、1セッションにつき最低$0.42です。

AI エージェントに任せる

このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。

Stream live AI video with the Lovely Router live video API and steer it while it plays.

- Docs (read first): https://lovelyrouter.com/docs/models/live-video.md
- POST https://lovelyrouter.com/v1/videos/live opens a server-sent event stream: `session`, `status`, `chunk` (each with an mp4 URL to play in order) and `end`. Steer the next chunk with POST .../<id>/prompt (or .../direct with a director), stop with .../stop; closing the stream ends it too.
- Needs `consent: true` (read the licence linked in the docs first). Billed per second streamed with a minimum per session; one open session per account.
- 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 first frame or scene, what should happen and how you will steer it>
01

ストリームで返るもの

イベントタイミング内容
session最初セッションの id、seconds_per_chunk、price_per_second、price_min
statusGPUの起動中、ディレクターの執筆中、またはチャンクに時間がかかっている間state(starting、directing、rendering、director_error)、waiting_s
nextディレクターが次のチャンクのプロンプトを書いたときindex、prompt、by
chunk動画約5秒ごとに1回index、mp4のurl、従ったprompt、by(directorまたはyou)、これまでのcharge_usd
end最後reason(max_seconds、stopped、client_left、insufficient_quota、error)、seconds、charge_usd

チャンクのURLにAPIキーは不要で、それぞれ推測できない独自のパスにあり、7日間保持されます。

02

ストリームを開始する

010203

ltx-live(LTX-2.5)は704×384の横向き、または384×704の縦向きを24 fpsで音付きでレンダリングし、リアルタイムより速く処理します。5秒のチャンクは約3秒かかります。すべてのリクエストでconsent: trueを設定し、LTXの利用規約に同意します。

curl -N https://lovelyrouter.com/v1/videos/live \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model": "ltx-live", "prompt": "A fox trots through fresh snow at dusk, the camera tracking beside it", "seconds": 120, "consent": true}'

seconds(5〜600、デフォルト60)はストリームが生成する最大値です。停止したとき、または接続を閉じたときにも終了します。プロンプトは最大1,000文字です。画面に何があるか、何が起きるか、光とカメラを伝えてください。短いプロンプトほど最速でレンダリングされます。

再生する。 GPUがウォームアップされていない場合、最初のチャンクには最大約1分かかることがあり、その間はstatusイベントが届きます。その後、チャンクは再生より少し速く到着します。2つをバッファリングし、前のチャンクが終わるたびに次を再生してください。2つの<video>要素を入れ替えると、途切れなく再生できます。コードなしで試すには、ライブモードのプレイグラウンドを開いてください。

03

再生中に操作する

LIVE_IDはsessionイベントのid、またはx-lovely-request-idヘッダーです。

プロンプトを変更する。

{"prompt": "…"}を付けてPOST /v1/videos/live/LIVE_ID/promptを呼びます。次に開始するチャンクはそれを一言一句従います。現在レンダリング中のチャンクは自身のプロンプトを維持します。

指示を出す。

ディレクターを使っている場合、{"message": "…"}を付けてPOST /v1/videos/live/LIVE_ID/directを呼ぶと、次に書くプロンプトに指示が組み込まれます。1セッションにつき最大100件の指示です。

停止する。

POST /v1/videos/live/LIVE_ID/stopは、進行中のチャンクの後にセッションを終了します。

振り返る。

GET /v1/videos/live/LIVE_IDはセッションを返します。これまでのすべてのチャンクURL、指示、ステータス、終了後は料金です。

cURL
curl https://lovelyrouter.com/v1/videos/live/LIVE_ID/prompt \
  -H "Authorization: Bearer $LOVELY_API_KEY" -H "content-type: application/json" \
  -d '{"prompt": "It starts to snow harder; the fox stops and looks up"}'
04

ディレクター

{}

directorにはチャットモデルのid、またはスタイルとストーリーに関するメモ(最大2,000文字)を添えた{"model": "…", "instructions": "…"}を設定します。1つのチャンクがレンダリングされている間に、ディレクターは「続けて」と言われたかのように次を書きます。あなたのプロンプト、直近15ショット、それ以降にあなたが言ったことから書きます。同じ人物、場所、見た目を保ち、ショットごとにアクションを少し進め、カメラが何をするか、何が聞こえるかを書き、話し言葉は誰が言うかとともに引用符で書きます。1チャンクあたり約10語です。プロンプトが書かれた後に届いた指示は、そのチャンクが始まる前にプロンプトを書き直させます。そのため、指示は数秒以内に反映されます。

cURL
curl -N https://lovelyrouter.com/v1/videos/live \
  -H "Authorization: Bearer $LOVELY_API_KEY" -H "content-type: application/json" \
  -d '{"model": "ltx-live", "prompt": "A woman walks home through a rainy city at night", "seconds": 300,
       "director": {"model": "claude-haiku-5.5", "instructions": "Slow, moody, film noir"}, "consent": true}'

高速で安価なモデルで十分です。ディレクターには1回の呼び出しにつき約10秒あり、claude-haiku-5.5は約6秒かかります。その呼び出しは、そのモデルの料金で通常のチャット呼び出しとして課金され、ログに表示されます。呼び出しが失敗した場合、動画は最後のプロンプトを維持します。

05

最初のフレーム、固定カメラ、声

最初のフレーム。

image(ファイル、http(s) URL、またはdata: URL。PNG、JPEG、WebPで最大15 MB)を送ると、画像から開始し、中央からそのサイズに切り抜かれます。これはストリームの参照として残るため、ストリームがどれだけ続いても、顔、服、部屋はその画像のまま保たれます。画像APIで作成し、ファイルを渡してください。

固定カメラ。

"camera": "fixed"はストリームを1つの固定ショットにします。カメラに向かって話す人、部屋、窓などに使います。カメラは決して動かず、カットもせず、各チャンクはきれいにした部屋のコピーから始まるため、長いショットでも背景が徐々に失われません。

声。

デフォルトでは、発話のある最初のチャンクで聞こえた声が、以降のすべてのチャンクで維持されます(keep_voice)。自分で選ぶには、1人の話者による明瞭な発話の約5秒のクリップをvoiceとして送ります。"keep_voice": falseにすると、各チャンクが独自の声を作ります。

再現可能。

seedを指定すると、チャンクnはseed + nを使います。

06

料金

生成した動画1秒あたり$0.019、1セッションにつき最低$0.42(動画約22秒分)で、GPUの起動と待機状態の維持をカバーします。セッション開始時に、最大コストであるseconds×料金が残高から保留されます。残高が少ない場合は保留額も少なくなり、それが使い切られた時点でストリームはinsufficient_quotaで終了します。保留は終了時に解放され、生成した秒数は1回の呼び出しとして課金されます。当社のエラーで終了したセッションは、最低額なしで、生成した動画分のみ支払います。ディレクターの呼び出しはチャットとして別途課金されます。同じ残高に関するその他については料金をご覧ください。

モデル入力 → 出力価格
LTX-2.5 Live
ltx-live
text+image→live video1 秒 $0.019

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

07

制限

  • アカウントごとに開けるセッションは1つです。最初のセッションが終了するまで、2つ目は429になります。
  • 少数のGPUがモデルを提供します。すべてがストリーミング中の場合、新しいセッションはretry-after付きの503になります。
  • セッションは最大600秒実行されます。続けるには、別のセッションを開始し、最後のチャンクの最終フレームをimageとして渡します。
08

よくある質問

?
ライブ動画APIとは何ですか?+

視聴中に動画を作り続けるエンドポイントで、完成した1本のクリップを返すものではありません。ここでは約5秒のmp4チャンクをサーバー送信イベントとしてストリーミングし、各チャンクは前のチャンクから続きます。プロンプトはいつでも変更できます。

ライブ動画の料金はいくらですか?+

生成した動画1秒あたり$0.019で、1セッションにつき最低$0.42です。ディレクターモデルの呼び出しは、そのモデルの料金でチャットとして課金されます。

ライブ動画はどれくらい実行できますか?+

1セッションにつき最大600秒です。同じショットを続けるには、最後のフレームをimageとして新しいセッションを開始します。

動画に音はありますか?+

はい。各チャンクには、プロンプトからモデルが作る独自の音があり、話し言葉も含まれます。話者の声はデフォルトでチャンク間で維持されるか、アップロードできます。

同じ人物を画面に残せますか?+

はい。最初のフレームはストリームの参照として残るため、そこにいる人物と場所はストリーム全体で保たれます。

どのライセンスが適用されますか?+

LTXの利用規約です。すべてのリクエストでconsent: trueを設定し、それらと従う責任に同意します。

タグ付きキャラクターの完成クリップについては動画ショットAPIを、曲を動画にする場合はミュージックビデオをご覧ください。

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

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