ブラックフライデーチャージボーナス
対象のチャージごとに無料クレジットが付き、他の特典とも併用できます。
11月30日まで
ライブ動画はレンダリングが終わっても終わりません。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>
ストリームで返るもの
| イベント | タイミング | 内容 |
|---|---|---|
session | 最初 | セッションの id、seconds_per_chunk、price_per_second、price_min |
status | GPUの起動中、ディレクターの執筆中、またはチャンクに時間がかかっている間 | 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日間保持されます。
ストリームを開始する
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>要素を入れ替えると、途切れなく再生できます。コードなしで試すには、ライブモードのプレイグラウンドを開いてください。
再生中に操作する
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 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"}'ディレクター
directorにはチャットモデルのid、またはスタイルとストーリーに関するメモ(最大2,000文字)を添えた{"model": "…", "instructions": "…"}を設定します。1つのチャンクがレンダリングされている間に、ディレクターは「続けて」と言われたかのように次を書きます。あなたのプロンプト、直近15ショット、それ以降にあなたが言ったことから書きます。同じ人物、場所、見た目を保ち、ショットごとにアクションを少し進め、カメラが何をするか、何が聞こえるかを書き、話し言葉は誰が言うかとともに引用符で書きます。1チャンクあたり約10語です。プロンプトが書かれた後に届いた指示は、そのチャンクが始まる前にプロンプトを書き直させます。そのため、指示は数秒以内に反映されます。
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秒かかります。その呼び出しは、そのモデルの料金で通常のチャット呼び出しとして課金され、ログに表示されます。呼び出しが失敗した場合、動画は最後のプロンプトを維持します。
最初のフレーム、固定カメラ、声
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を使います。
料金
生成した動画1秒あたり$0.019、1セッションにつき最低$0.42(動画約22秒分)で、GPUの起動と待機状態の維持をカバーします。セッション開始時に、最大コストであるseconds×料金が残高から保留されます。残高が少ない場合は保留額も少なくなり、それが使い切られた時点でストリームはinsufficient_quotaで終了します。保留は終了時に解放され、生成した秒数は1回の呼び出しとして課金されます。当社のエラーで終了したセッションは、最低額なしで、生成した動画分のみ支払います。ディレクターの呼び出しはチャットとして別途課金されます。同じ残高に関するその他については料金をご覧ください。
| モデル | 入力 → 出力 | 価格 |
|---|---|---|
| LTX-2.5 Live ltx-live | text+image→live video | 1 秒 $0.019 |
米ドルのリアルタイム価格。API の請求額と同じです。
制限
- アカウントごとに開けるセッションは1つです。最初のセッションが終了するまで、2つ目は
429になります。 - 少数のGPUがモデルを提供します。すべてがストリーミング中の場合、新しいセッションは
retry-after付きの503になります。 - セッションは最大600秒実行されます。続けるには、別のセッションを開始し、最後のチャンクの最終フレームを
imageとして渡します。
よくある質問
ライブ動画APIとは何ですか?+
視聴中に動画を作り続けるエンドポイントで、完成した1本のクリップを返すものではありません。ここでは約5秒のmp4チャンクをサーバー送信イベントとしてストリーミングし、各チャンクは前のチャンクから続きます。プロンプトはいつでも変更できます。
ライブ動画の料金はいくらですか?+
生成した動画1秒あたり$0.019で、1セッションにつき最低$0.42です。ディレクターモデルの呼び出しは、そのモデルの料金でチャットとして課金されます。
ライブ動画はどれくらい実行できますか?+
1セッションにつき最大600秒です。同じショットを続けるには、最後のフレームをimageとして新しいセッションを開始します。
動画に音はありますか?+
はい。各チャンクには、プロンプトからモデルが作る独自の音があり、話し言葉も含まれます。話者の声はデフォルトでチャンク間で維持されるか、アップロードできます。
同じ人物を画面に残せますか?+
はい。最初のフレームはストリームの参照として残るため、そこにいる人物と場所はストリーム全体で保たれます。
どのライセンスが適用されますか?+
LTXの利用規約です。すべてのリクエストでconsent: trueを設定し、それらと従う責任に同意します。