Бонус за пополнение: Чёрная пятница·Пополните от $50 и получите $10 · Пополните от $100 и получите $25·До 30 ноябряПополнить →
Видео

Live video API, транслирующий бесконечный кадр

Поток видеофрагментов по ~5 с со звуком через POST /v1/videos/live. Управление промптами или моделью-режиссёром, оплата по секундам.

Обновлено 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
Чёрная пятница

Бонус за пополнение: Чёрная пятница

Каждое подходящее пополнение даёт бесплатные средства, а также суммируется с другими предложениями.

До 30 ноября

Пополнение $50
+$10
Бонус 20%
Пополнение $100
+$25
Бонус 25%
Зарегистрироваться и получить

Живое видео не заканчивается вместе с рендером. 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>
01

Что приходит в потоке

СобытиеКогдаЧто содержит
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 дней.

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 не разогрет, а пока приходят события status. Дальше фрагменты приходят немного быстрее, чем проигрываются. Забуферьте два, затем включайте каждый, когда заканчивается предыдущий; два подменяющих друг друга элемента <video> проигрывают это без разрывов. Чтобы попробовать без кода, откройте плейграунд в live-режиме.

03

Управляйте на ходу

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
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 МБ), чтобы начать с картинки, обрезанной до нужного размера от центра. Она остаётся референсом потока: лица, одежда и комната сохраняются такими, как на ней, сколько бы ни длился поток. Создайте её через image 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. Когда все стримят, новая сессия получает 503 с retry-after.
  • Сессия длится до 600 секунд. Чтобы продолжить, запустите новую и передайте последний кадр последнего фрагмента как image.
08

Частые вопросы

?
Что такое live video API?+

Эндпоинт, который продолжает делать видео, пока вы смотрите, вместо возврата одного готового клипа. Здесь он отдаёт mp4-фрагменты по ~5 с как server-sent events, каждый продолжает предыдущий, и вы можете сменить промпт в любой момент.

Сколько стоит живое видео?+

$0.019 за секунду созданного видео, минимум $0.42 за сессию. Вызовы модели-режиссёра тарифицируются как чат по цене этой модели.

Сколько может длиться живое видео?+

До 600 секунд за сессию. Запустите новую сессию с последнего кадра в image, чтобы продолжить тот же кадр.

Есть ли у видео звук?+

Да. У каждого фрагмента свой звук, созданный моделью по промпту, включая реплики. Голос говорящего по умолчанию сохраняется между фрагментами, или вы можете загрузить свой.

Можно ли сохранить одного и того же человека в кадре?+

Да. Первый кадр остаётся референсом потока, поэтому люди и место на нём сохраняются на весь поток.

Какая лицензия действует?+

Условия LTX. В каждом запросе указывается consent: true — принятие их и ответственности за их соблюдение.

Для готовых клипов с помеченными персонажами см. video shots API; для превращения песни в видео — музыкальные клипы.

Один предоплаченный ключ для моделей, данных и агентов

Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.