Live video API, транслирующий бесконечный кадр
Поток видеофрагментов по ~5 с со звуком через POST /v1/videos/live. Управление промптами или моделью-режиссёром, оплата по секундам.
Обновлено 2026-11-05
Бонус за пополнение: Чёрная пятница
Каждое подходящее пополнение даёт бесплатные средства, а также суммируется с другими предложениями.
До 30 ноября
Живое видео не заканчивается вместе с рендером. POST /v1/videos/live открывает поток server-sent events, который каждые несколько секунд отдаёт новый mp4-фрагмент примерно на 5 секунд. Каждый фрагмент продолжает последнюю секунду предыдущего, вместе с движением, поэтому при воспроизведении подряд они складываются в один непрерывный кадр с собственным звуком. Вы меняете то, что будет дальше, прямо во время воспроизведения: отправляете новый промпт или позволяете режиссёру — чат-модели — писать каждый следующий кадр и учитывать ваши указания. Это стоит $0.019 за секунду созданного видео, минимум $0.42 за сессию.
Передайте это своему ИИ-агенту
Скопируйте этот промпт в 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, url mp4-файла, 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 не разогрет, а пока приходят события status. Дальше фрагменты приходят немного быстрее, чем проигрываются. Забуферьте два, затем включайте каждый, когда заканчивается предыдущий; два подменяющих друг друга элемента <video> проигрывают это без разрывов. Чтобы попробовать без кода, откройте плейграунд в live-режиме.
Управляйте на ходу
LIVE_ID — это id из события session или заголовок 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 МБ), чтобы начать с картинки, обрезанной до нужного размера от центра. Она остаётся референсом потока: лица, одежда и комната сохраняются такими, как на ней, сколько бы ни длился поток. Создайте её через image 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. Когда все стримят, новая сессия получает
503сretry-after. - Сессия длится до 600 секунд. Чтобы продолжить, запустите новую и передайте последний кадр последнего фрагмента как
image.
Частые вопросы
Что такое live video API?+
Эндпоинт, который продолжает делать видео, пока вы смотрите, вместо возврата одного готового клипа. Здесь он отдаёт mp4-фрагменты по ~5 с как server-sent events, каждый продолжает предыдущий, и вы можете сменить промпт в любой момент.
Сколько стоит живое видео?+
$0.019 за секунду созданного видео, минимум $0.42 за сессию. Вызовы модели-режиссёра тарифицируются как чат по цене этой модели.
Сколько может длиться живое видео?+
До 600 секунд за сессию. Запустите новую сессию с последнего кадра в image, чтобы продолжить тот же кадр.
Есть ли у видео звук?+
Да. У каждого фрагмента свой звук, созданный моделью по промпту, включая реплики. Голос говорящего по умолчанию сохраняется между фрагментами, или вы можете загрузить свой.
Можно ли сохранить одного и того же человека в кадре?+
Да. Первый кадр остаётся референсом потока, поэтому люди и место на нём сохраняются на весь поток.
Какая лицензия действует?+
Условия LTX. В каждом запросе указывается consent: true — принятие их и ответственности за их соблюдение.
Для готовых клипов с помеченными персонажами см. video shots API; для превращения песни в видео — музыкальные клипы.
Один предоплаченный ключ для моделей, данных и агентов
Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.