黑色星期五充值赠礼
每笔符合条件的充值都可获赠额度,并可与其他优惠叠加。
11月30日截止
实时视频不会在渲染结束时就停下。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>
流式返回的内容
| 事件 | 时机 | 携带内容 |
|---|---|---|
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 秒视频一次 | 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)以 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> 元素可以无缝播放。想不写代码试用,请打开实时模式的演练场。
在播放过程中引导它
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 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,或设为 {"model": "…", "instructions": "…"} 并附上关于风格和故事的说明(最多 2,000 个字符)。当一段分片在渲染时,导演会像被告知“继续”一样撰写下一段:依据你的提示词、最近 15 个镜头以及你此后说过的任何内容。它保持相同的人物、地点和外观,每个镜头把动作推进一点,说明镜头如何运动、我们听到什么,并用引号写出对白并注明说话者,每段分片约 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}'一个快速、便宜的模型就足够了:导演每次调用约有 10 秒,而 claude-haiku-5.5 约需 6 秒。它的调用按该模型的价格作为普通对话调用计费,并出现在你的日志中。如果调用失败,视频会沿用上一个提示词。
首帧、固定镜头和声音
发送 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。
费用
每生成一秒视频 $0.019,每个会话至少 $0.42,约 22 秒视频,用于覆盖启动 GPU 并使其保持就绪。会话开始时,会从你的余额中冻结它可能产生的最高费用,即 seconds × 单价;如果你的余额更低,冻结的金额就更少,当这部分用完时,流会以 insufficient_quota 结束。冻结金额在结束时释放,已生成的秒数作为一次调用计费。因我方错误而结束的会话只为它生成的视频付费,不含最低费用。导演的调用作为对话单独计费。同一余额上的其他所有费用见定价。
| 模型 | 输入 → 输出 | 价格 |
|---|---|---|
| LTX-2.5 Live ltx-live | text+image→live video | 每秒 $0.019 |
实时美元价格,与 API 实际收费相同。
限制
- 每个账户只能有一个打开的会话;第二个会收到
429,直到第一个结束。 - 为该模型服务的 GPU 数量不多。当它们都在流式输出时,新会话会收到带
retry-after的503。 - 一个会话最长运行 600 秒。要继续下去,请再开一个会话,并把上一段分片的最后一帧作为
image传入。
常见问题
什么是实时视频 API?+
一个在你观看的同时持续生成视频的端点,而不是返回一段已完成的片段。这里它以服务器发送事件的形式流式输出约 5 秒的 mp4 分片,每一段都接续上一段,你可以随时更改提示词。
实时视频要多少钱?+
每生成一秒视频 $0.019,每个会话最低 $0.42。导演模型的调用按该模型的价格作为对话计费。
实时视频能运行多久?+
每个会话最长 600 秒。把最后一帧作为 image 开启新会话,即可延续同一个镜头。
视频有声音吗?+
有。每段分片都有自己的声音,由模型根据提示词生成,包括对白。说话者的声音默认在分片之间保留,你也可以上传一个。
我能让同一个人一直出现在屏幕上吗?+
可以。首帧会一直是这条流的参照,因此其中的人物和地点会在整条流中保持不变。
适用什么许可?+
LTX 条款。每个请求都设置 consent: true,即表示接受这些条款以及遵守它们的责任。