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

Генератор коротких драм с ИИ:
каст, декорации и эпизод через API

Короткие драмы из кода: сохраните каст и декорации один раз, опишите кадры через @теги и реплики в кавычках, склейте их в эпизод бесплатно.

Обновлено 2026-11-05

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
shots$ curl https://lovelyrouter.com/v1/videos/shots -H "Authorization: …> @mia hands @leo the letter in @kitchen. "You kept it?" shot rendering · 5 s · 2 characters ⏺ POST /v1/videos/joins [shot_1, shot_2, shot_3] ✓ episode.mp4 ready
Чёрная пятница

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

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

До 30 ноября

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

Короткая драма держится на одних и тех же лицах, одних и тех же комнатах и реплике каждые несколько секунд, эпизод за эпизодом. Именно для этого сделаны видеокадры. Сохраните свой каст один раз как персонажей (лист поворотов и голос для каждого) и декорации как сцены. Пишите каждый кадр как предложение, в котором отмечено кто и где: In @[Penthouse], @Lena slaps the contract on the table: "You lied to me.", — и кадр вернётся с этими лицами, этой комнатой, звуком и репликой, произнесённой голосом Лины. Соедините готовые кадры в эпизод бесплатно и храните раскадровку в проекте. Вертикальный 9:16 для приложений коротких видео, 16:9 для всего остального, и без единой строки кода в видеоплощадке.

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

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

Build a tool that turns a short drama script into vertical episodes with Lovely Router saved characters, scenes, video shots and free joins.

- Docs (read first): https://lovelyrouter.com/docs/api/video-shots.md and https://lovelyrouter.com/docs/api/characters.md
- Save the cast and sets (POST https://lovelyrouter.com/v1/characters, /v1/scenes), write each shot with `@handle` tags and quoted dialogue to POST https://lovelyrouter.com/v1/videos/shots (`consent: true`), poll, then POST https://lovelyrouter.com/v1/videos/joins.
- 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 cast, the sets and the episode script>
01

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

010203
  1. Соберите каст сериала

    Нарисуйте каждого героя как лист поворотов с помощью API генерации изображений и сохраните его через POST /v1/characters — бесплатно. Привяжите к каждому голос: голос, созданный в синтезе речи, или запись актёра, который на это согласился.

  2. Постройте декорации

    Сохраните каждое повторяющееся место — офис, пентхаус, больничный коридор — через POST /v1/scenes: название, описание и картинку. До 100 сцен и 100 персонажей на аккаунт.

  3. Напишите кадры

    Один запрос на кадр: промпт, в котором отмечены персонажи и сцена, а реплики — в двойных кавычках. Каждый отмеченный персонаж становится референсной картинкой, поэтому лица, волосы, одежда и комната берутся из вашей библиотеки, а не из промпта. Кадры длятся от 5 до 15 секунд.

  4. Смонтируйте эпизод

    POST /v1/videos/joins соединяет до 50 готовых кадров одного размера по порядку, каждый со своим звуком, бесплатно. Храните список кадров эпизода, персонажей и сцены в проекте, чтобы можно было к нему вернуться.

02

Эпизод за несколько запросов

Python
import os
import requests

BASE = "https://lovelyrouter.com/v1"
H = {"Authorization": f"Bearer {os.environ['LOVELY_API_KEY']}"}

LENA = "chr_3b9e1f0c7a2d4e58b6c1a9f2"   # saved with POST /v1/characters
MARCUS = "chr_1e4b7d0a9c3f2e5b8a6d0c1f"
PENTHOUSE = "scn_5b2d9e0c1a7f4b3e8d6c2a1f"  # saved with POST /v1/scenes

project = requests.post(f"{BASE}/videos/projects", headers=H,
                        json={"name": "The Contract, episode 3", "doc": {"size": "9:16"}}).json()

script = [
    'In @[Penthouse], @Lena storms in and slaps the contract on the table: "You lied to me."',
    '@Marcus looks up from the window, calm: "I protected you."',
    '@Lena laughs once, without humour, and steps closer to @Marcus: "From what?"',
]

shot_ids = []
for line in script:
    shot = requests.post(f"{BASE}/videos/shots?wait=300", headers=H, json={
        "model": "minimax-h3-video",
        "consent": True,
        "prompt": line,
        "characters": [LENA, MARCUS],
        "scenes": [PENTHOUSE],
        "size": "9:16",
        "seconds": 8,
        "project_id": project["id"],
    }).json()
    while shot["status"] in ("queued", "in_progress"):
        shot = requests.get(f"{BASE}/videos/shots/{shot['id']}?wait=120", headers=H).json()
    shot_ids.append(shot["id"])

episode = requests.post(f"{BASE}/videos/joins", headers=H,
                        json={"shots": shot_ids, "project_id": project["id"]}).json()
print(episode["id"], episode["status"])

Когда склейка готова, скачайте её через GET /v1/videos/joins/{id}/content. Здесь кадры делаются по одному ради наглядности; на аккаунте может одновременно стоять в очереди или рендериться пять кадров или склеек, так что можно отправить несколько, прежде чем ждать. В справочнике по видеокадрам те же вызовы на cURL и Node.js.

03

Инструменты для работы

Сохранённые персонажи

POST /v1/characters: имя, описание и лист поворотов (спереди, в три четверти, в профиль и со спины, с шестью выражениями лица). Сохраните сгенерированный лист по id задачи изображения через sheet_image_job. См. персонажи.

Голоса персонажей

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

Сохранённые сцены

POST /v1/scenes: место и его картинка, отмечается как персонаж (@[Night Café]).

Теги и реплики

@Lena, @[Full Name] или id. Слова в двойных кавычках произносит персонаж, отмеченный последним перед ними. Кадр принимает от 1 до 9 картинок.

Проход по местоимениям

При двух и более персонажах чат-модель переписывает he, she и they вне реплик в теги, чтобы видеомодель знала, кто что делает. Реплики никогда не меняются. Отправьте sweep: false, чтобы отрендерить промпт ровно как написано.

Склейки и проекты

Склейки бесплатны и сохраняют звук каждого кадра. Проект хранит вашу собственную JSON-раскадровку, до 200 КБ, бесплатно, до 100 на аккаунт.

Язык и вид

language задаёт язык, на котором произносятся реплики (en, zh, ja, …); style задаёт вид, например warm 35mm film; seed делает кадр воспроизводимым.

04

Как писать работающие кадры

{}
Отмечайте каждого человека, каждый раз

Картинки несут лица и одежду, поэтому промпт говорит только о том, что происходит. Не описывайте, как персонаж выглядит; описывайте, что он делает.

Один бит на кадр

Примерно одна реплика и одно действие помещаются в кадр на 5–8 секунд. Длинную речь лучше разбить на два кадра.

Начинайте с кадра, когда это важно

Для склейки, которая должна совпасть, отправьте кадр как сцену и напишите The shot opens exactly on @[Opening frame] as its first frame. Начало следует за ним близко, хотя и не пиксель в пиксель.

Меняйте костюмы осознанно

Новый костюм — это новый лист: обновите персонажа через PATCH /v1/characters/{id} или сохраните костюм как отдельного персонажа. Уже созданные видео остаются с тем листом, который использовали.

Пусть сценарий набросает чат-модель

Любая чат-модель на вашем ключе превратит синопсис в нумерованный список кадров в этом формате; вы проверяете его до того, как что-либо отрендерится.

05

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

Кадр оплачивается за отрендеренную секунду: $0.13 с одной картинкой плюс $0.06 за секунду за каждую дополнительную картинку. Модель рендерит по фиксированной сетке кадров, поэтому кадр на 5 секунд оплачивается как 5.17 секунды, а на 10 секунд — как 10.13 секунды. Эпизод на минуту из шести 10-секундных кадров, в каждом два персонажа и сцена (три картинки), стоит около $15.20. Чат-вызовы прохода по местоимениям оплачиваются как обычные чат-запросы на том же ключе. Персонажи, сцены, голоса, проекты и склейки бесплатны. Каждый кадр резервируется с вашего предоплаченного баланса при отправке и списывается при завершении; неудачные и отменённые кадры ничего не стоят. Листы и кадры стоят $0.04 за изображение. Все цены — на странице тарифов.

06

Условия и ответственное использование

minimax-h3-video подчиняется условиям MiniMax H3: каждый кадр выставляет consent: true, принимая их, в том числе обязательство не использовать модель в ЕС, Великобритании, Южной Корее и США. Используйте лица и голоса, которыми владеете или на которые есть разрешение; касту на основе реальных людей нужно их согласие. Действует Политика допустимого использования. Готовые кадры и склейки хранятся 7 дней, поэтому скачивайте каждый эпизод, когда он готов.

07

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

?
Персонажи выглядят одинаково в каждом кадре?+

Да, в этом и смысл тегов. Лист поворотов каждого отмеченного персонажа служит референсной картинкой для кадра, поэтому лицо, волосы и одежда каждый раз берутся из него. Не описывайте их внешность в промпте.

Персонажи могут говорить?+

Да. Поставьте реплику в двойных кавычках после тега персонажа, и она прозвучит в кадре, а звук сделает видеомодель. Персонаж с сохранённым голосом говорит этим голосом.

Какой длины может быть кадр?+

От 5 до 15 секунд. Эпизод — это склейка до 50 кадров, все одного размера и не старше 7 дней.

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

Да. Задайте language как zh, ja или другой код и пишите реплики на этом языке. Теги работают с любым именем.

Можно ли отредактировать один кадр, не переделывая эпизод?+

Да. Отрендерьте новую версию этого кадра, затем склейте список кадров заново, поставив новый id на его место. Склейки бесплатны.

Есть ли инструмент для раскадровок?+

Площадка хранит свои раскадровки как проекты, и то же самое можно делать из кода через POST /v1/videos/projects и собственный JSON.

Может ли ИИ-агент делать эпизоды за меня?+

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

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

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

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