黑色星期五充值赠礼·充值 $50 起送 $10 · 充值 $100 起送 $25·11月30日截止充值 →
视频

流式输出无尽长镜头的实时视频 API

POST /v1/videos/live 每隔几秒流式输出约 5 秒、带声音且彼此衔接的视频分片。用提示词或导演模型来引导它。按秒计费。

最后更新于 2026-11-05

预付费,无订阅REST 或 MCP一个密钥搞定模型、数据和智能体
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 分片。每一段都从上一段的最后一秒接续下去,连动作也接得上,所以连续播放时它们构成一个带自身声音的连续镜头。你可以在播放过程中改变接下来发生的事:发送新的提示词,或者交给一位导演——一个对话模型——来撰写每一个后续镜头并采纳你的指示。费用为每生成一秒视频 $0.019,每个会话最低 $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 秒视频一次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)以 24 fps 渲染 704×384 横屏或 384×704 竖屏,带声音,速度快于实时:一段 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 预热时,第一段分片最多可能要等约一分钟,其间会有 status 事件。之后,分片到达的速度会略快于播放速度。先缓冲两段,然后在前一段结束时播放下一段;两个交替切换的 <video> 元素可以无缝播放。想不写代码试用,请打开实时模式的演练场。

03

在播放过程中引导它

LIVE_ID 是 session 事件中的 id,或 x-lovely-request-id 响应头。

更改提示词。

POST /v1/videos/live/LIVE_ID/prompt,请求体为 {"prompt": "…"}。下一个开始的分片会逐字遵循它;正在渲染的那一段则保持自己的提示词。

给出指示。

在启用导演时,POST /v1/videos/live/LIVE_ID/direct,请求体为 {"message": "…"},会把该指示融入它接下来撰写的提示词,每个会话最多 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,或设为 {"model": "…", "instructions": "…"} 并附上关于风格和故事的说明(最多 2,000 个字符)。当一段分片在渲染时,导演会像被告知“继续”一样撰写下一段:依据你的提示词、最近 15 个镜头以及你此后说过的任何内容。它保持相同的人物、地点和外观,每个镜头把动作推进一点,说明镜头如何运动、我们听到什么,并用引号写出对白并注明说话者,每段分片约 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}'

一个快速、便宜的模型就足够了:导演每次调用约有 10 秒,而 claude-haiku-5.5 约需 6 秒。它的调用按该模型的价格作为普通对话调用计费,并出现在你的日志中。如果调用失败,视频会沿用上一个提示词。

05

首帧、固定镜头和声音

首帧。

发送 image(文件、http(s) URL 或 data: URL;PNG、JPEG 或 WebP,最大 15 MB)以从一张图片开始,图片会从中心裁剪到目标尺寸。它会一直是这条流的参照:无论流运行多久,人脸、衣着和房间都保持图片中的样子。可以用图像 API 生成一张并传入该文件。

固定镜头。

"camera": "fixed" 会让这条流成为一个锁定机位,适合对着镜头说话的人、一个房间或一扇窗。镜头从不移动或切换,每段分片都从房间的一份清理过的副本开始,这样长镜头不会慢慢丢失背景。

声音。

默认情况下,第一段带语音的分片中所听到的声音会保留到之后每一段(keep_voice)。发送 voice——一段约 5 秒、来自单一说话者的清晰语音——来自己选择声音;"keep_voice": false 则让每段分片各自生成声音。

可复现。

使用 seed 时,第 n 段分片使用 seed + n。

06

费用

每生成一秒视频 $0.019,每个会话至少 $0.42,约 22 秒视频,用于覆盖启动 GPU 并使其保持就绪。会话开始时,会从你的余额中冻结它可能产生的最高费用,即 seconds × 单价;如果你的余额更低,冻结的金额就更少,当这部分用完时,流会以 insufficient_quota 结束。冻结金额在结束时释放,已生成的秒数作为一次调用计费。因我方错误而结束的会话只为它生成的视频付费,不含最低费用。导演的调用作为对话单独计费。同一余额上的其他所有费用见定价。

模型输入 → 输出价格
LTX-2.5 Live
ltx-live
text+image→live video每秒 $0.019

实时美元价格,与 API 实际收费相同。

07

限制

  • 每个账户只能有一个打开的会话;第二个会收到 429,直到第一个结束。
  • 为该模型服务的 GPU 数量不多。当它们都在流式输出时,新会话会收到带 retry-after 的 503。
  • 一个会话最长运行 600 秒。要继续下去,请再开一个会话,并把上一段分片的最后一帧作为 image 传入。
08

常见问题

?
什么是实时视频 API?+

一个在你观看的同时持续生成视频的端点,而不是返回一段已完成的片段。这里它以服务器发送事件的形式流式输出约 5 秒的 mp4 分片,每一段都接续上一段,你可以随时更改提示词。

实时视频要多少钱?+

每生成一秒视频 $0.019,每个会话最低 $0.42。导演模型的调用按该模型的价格作为对话计费。

实时视频能运行多久?+

每个会话最长 600 秒。把最后一帧作为 image 开启新会话,即可延续同一个镜头。

视频有声音吗?+

有。每段分片都有自己的声音,由模型根据提示词生成,包括对白。说话者的声音默认在分片之间保留,你也可以上传一个。

我能让同一个人一直出现在屏幕上吗?+

可以。首帧会一直是这条流的参照,因此其中的人物和地点会在整条流中保持不变。

适用什么许可?+

LTX 条款。每个请求都设置 consent: true,即表示接受这些条款以及遵守它们的责任。

关于带标记角色的成片,见视频镜头 API;关于把一首歌变成视频,见音乐视频。

一个预付费密钥,搞定模型、数据和智能体

无需订阅。充值后按需使用,每笔费用都能在日志中查看。