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

Стрим AI-втубера:
бесконечный ведущий в видео, которым управляет чат

Запустите AI-втубера через API: живое видео без конца, режиссёр на каждый следующий кадр, один голос и чат зрителей как команды.

Обновлено 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%
Зарегистрироваться и получить

AI-втуберу нужно три вещи, которых не даст записанный клип: видео, которое не кончается, голос, который не меняется, и способ для зрителей влиять на то, что будет дальше. API живого видео даёт все три. POST /v1/videos/live открывает поток, который каждые несколько секунд отдаёт новый mp4-фрагмент примерно на 5 секунд, и каждый продолжает движение предыдущего. Чат-модель, режиссёр, пишет каждый следующий кадр исходя из образа персонажа. Голос, услышанный в первом фрагменте с речью, сохраняется на весь стрим, либо вы присылаете свой клип. А пока стрим идёт, POST /v1/videos/live/{id}/direct принимает сообщение, так что ваш бот может передать просьбы зрителей и увидеть их на экране за считанные секунды. Попробуйте без кода в живой песочнице.

Передайте это своему ИИ-агенту

Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.

Build an AI VTuber for me: stream live video from the Lovely Router live video API with one kept voice, and turn filtered viewer chat messages into directions.

- Docs (read first): https://lovelyrouter.com/docs/models/live-video.md and https://lovelyrouter.com/docs/api/audio.md
- Live video: POST https://lovelyrouter.com/v1/videos/live (server-sent events with mp4 chunks), steer with .../prompt or .../direct; `consent: true` required. Sending the chunks to a streaming platform is this project's job.
- 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 character, a voice clip, the platform and where the chat comes from>
01

Как это работает

010203
  1. Нарисуйте ведущего

    Сделайте первый кадр через API генерации изображений: ваш втубер в своей комнате, в кадре под стрим. Живая модель сохраняет лица, одежду и комнату с этой картинки на всю сессию, сколько бы она ни шла.

  2. Дайте им голос и образ

    Пришлите voice — клип примерно на 5 секунд чистой речи одного человека, и каждый фрагмент будет говорить им. Клип может быть вашей записью, голосом, на который у вас есть разрешение, или голосом, созданным через синтез речи. Затем передайте director с instructions: кто ведущий, как он говорит, о чём шоу (до 2 000 символов).

  3. Выходите в эфир

    Режиссёр пишет промпт каждого фрагмента, пока рендерится предыдущий: что на экране, что происходит, что делает камера и что говорит ведущий, примерно 10 слов на фрагмент. Фрагменты приходят чуть быстрее, чем проигрываются, поэтому буферизуйте два и проигрывайте их подряд.

  4. Позвольте чату управлять

    Ваш бот читает чат стрима, выбирает сообщения, на которые стоит реагировать, и отправляет каждое в /direct. Режиссёр встраивает его в следующий кадр, который пишет, а указание, пришедшее после того, как кадр уже написан, приводит к переписыванию этого кадра до его начала.

02

Запустите стрим

010203
cURL
curl -N https://lovelyrouter.com/v1/videos/live \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -F model=ltx-live \
  -F prompt="Miko, a cheerful streamer with silver twin tails and a hoodie with cat ears, talks to the camera from her cosy room, fairy lights behind her" \
  -F seconds=600 \
  -F size=384x704 \
  -F camera=fixed \
  -F image=@miko-room.png \
  -F voice=@miko-voice.wav \
  -F director=claude-haiku-5.5 \
  -F director_instructions="Miko is upbeat and a bit silly. She chats with her viewers, answers their questions in one short sentence and reacts to what they ask for." \
  -F consent=true

В multipart-запросе заметки режиссёра идут в director_instructions; в JSON director — это объект с model и instructions. Ответ — поток server-sent events: сначала session (с id сессии), событие chunk с mp4 url на каждые ~5 секунд видео, next, когда режиссёр написал будущий кадр, и end при закрытии. URL фрагментов не требуют API-ключа, так что плеер может загружать их напрямую. Когда зритель что-то просит, отправьте это как указание:

Python
import os
import requests

H = {"Authorization": f"Bearer {os.environ['LOVELY_API_KEY']}"}

def direct(live_id: str, viewer: str, message: str) -> None:
    """Pass one chat message on to the director."""
    requests.post(
        f"https://lovelyrouter.com/v1/videos/live/{live_id}/direct",
        headers=H,
        json={"message": f"A viewer called {viewer} says: {message}"},
        timeout=30,
    ).raise_for_status()

# From your chat bot, after your own filters:
direct(LIVE_ID, "nightowl", "Show us your cat!")

В руководстве по живому видео есть полный список событий, читатель потока на Python и то, как проигрывать фрагменты без пауз.

03

Инструменты для задачи

API живого видео

POST /v1/videos/live с ltx-live: 704×384 в альбомной ориентации или 384×704 в портретной, 24 fps, со звуком, быстрее реального времени, когда GPU прогрет. Справочник: живое видео.

Режиссёр

Любая чат-модель, доступная вашему ключу, в виде id или {"model", "instructions"}. Он видит ваш промпт, последние 15 кадров и ваши указания. Быстрой и недорогой модели достаточно; claude-haiku-5.5 отвечает примерно за 6 секунд при отведённых примерно 10.

Два способа управлять

POST …/direct — это предложение, которое режиссёр встраивает в историю, и оно продолжает действовать (новое место, настроение, язык), где это уместно. POST …/prompt дословно заменяет промпт следующего фрагмента — для заготовленного момента вроде чтения рекламы или «сейчас вернусь».

Сохранённый голос

С voice каждый фрагмент говорит вашим клипом. Без него keep_voice (включён по умолчанию) сохраняет голос, услышанный в первом фрагменте с речью.

Фиксированная камера

camera: "fixed" делает стрим одним статичным кадром: двигаются только люди, а комната, с которой начинается каждый фрагмент, вычищается, чтобы фон не уплывал за долгую сессию.

Первый кадр и клип с голосом

Нарисуйте комнату через API изображений и создайте голос через синтез речи или склонируйте тот, на который у вас есть права, через клонирование голоса.

04

Что вы делаете сами

{}

API делает видео, трансляция — ваша. Проигрывайте URL фрагментов на своей странице или в своём плеере (два элемента <video>, переключение по завершении каждого, без пауз) и захватывайте это в софте для стриминга, чтобы отправить на платформу, где вы вещаете. Читать чат платформы, фильтровать его и решать, какие сообщения станут указаниями, — работа вашего бота: режиссёр делает то, что ему сказали, поэтому отсеивайте спам и грубость до того, как что-то дойдёт до /direct. Сессия принимает до 100 указаний, так что выбирайте лучшие, а не пересылайте каждую строку.

05

Ограничения, которые стоит учесть

10 минут на сессию

seconds доходит до 600. Для более долгого шоу запускайте следующую сессию, когда заканчивается текущая, и передавайте последний кадр последнего фрагмента как image, чтобы ведущий и комната продолжились. Первый фрагмент новой сессии должен отрендериться до проигрывания, поэтому планируйте короткую паузу или заранее готовый клип на каждую смену.

Одна открытая сессия на аккаунт

Вторая отклоняется с 429, пока не закончится первая.

Холодный старт

Когда нет прогретого GPU, первый фрагмент готовится до примерно минуты, а пока приходят события status.

Ёмкость

Модель обслуживает небольшое число GPU. Когда все стримят, новая сессия получает 503 с retry-after.

06

Сколько вы платите

Вы платите за каждую секунду созданного видео: $0.019 с ltx-live, или $1.14 за минуту, и не менее $0.42 за сессию. Полная 10-минутная сессия стоит $11.4, а час сессий подряд — $68.4. Вызовы режиссёра тарифицируются отдельно по цене этой чат-модели, а первый кадр и любой созданный голос — по ценам изображений и речи. Максимальная возможная стоимость сессии резервируется из вашего предоплаченного баланса при её запуске; созданные секунды списываются одним вызовом в ваших логах. Сессия, завершившаяся из-за нашей ошибки, оплачивается только за созданное видео. Все цены на странице тарифов.

07

Правила для живого AI-ведущего

ltx-live подпадает под условия LTX, которые принимает каждый запрос с consent: true. Среди них: указывайте, что видео сгенерировано ИИ, везде, где вы его показываете; не выдавайте себя за кого-то без его согласия; никакого откровенно сексуального контента. Используйте только голоса, которые ваши или на которые у вас есть разрешение, и картинки, на которые у вас есть права. Политика допустимого использования действует, как и для любой модели.

08

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

?
Зрители правда могут менять то, что делает втубер?+

Да. Каждое сообщение, отправленное в POST /v1/videos/live/{id}/direct, встраивается в следующий кадр, который пишет режиссёр, а ещё не снятые кадры сразу переписываются, так что указание появляется на экране за считанные секунды. Какие сообщения из чата отправлять, решает ваш бот.

Голос остаётся тем же?+

Да. Пришлите клип voice примерно на 5 секунд речи одного человека, и каждый фрагмент будет говорить им. Без него голос, услышанный в первом фрагменте с речью, сохраняется до конца стрима.

У ведущего остаётся то же лицо?+

Первый кадр — референс стрима: лица, одежда и комната сохраняются такими, как в нём, на всю сессию. Когда запускаете новую сессию, передайте последний кадр последнего фрагмента как image, чтобы продолжить.

Он может стримить прямо на мой канал?+

Нет. API отдаёт mp4-фрагменты через server-sent events. Вы проигрываете их в своём плеере и отправляете на платформу через софт для стриминга.

Сколько может идти один стрим?+

Одна сессия идёт до 600 секунд. Запускайте следующую, когда она закончится, чтобы продолжать; у аккаунта может быть открыта одна сессия за раз.

Какая чат-модель должна быть режиссёром?+

Быстрая и недорогая. У режиссёра около 10 секунд на вызов, прежде чем видео начнёт его ждать, а claude-haiku-5.5 отвечает примерно за 6. Подойдёт любая чат-модель, доступная вашему ключу.

AI-агент для кодинга может это собрать за меня?+

Да. Скопируйте промпт с этой страницы в Claude Code, Cursor или Codex: он направляет агента к Markdown-документации, и агент пишет читатель потока, плеер и чат-бота с вашим ключом.

Для записанных сцен с теми же персонажами смотрите видеокадры; чтобы получить API-ключ, зарегистрируйтесь и пополните баланс, затем откройте живую песочницу.

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

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