Бонус за пополнение: Чёрная пятница·Пополните от $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%
Зарегистрироваться и получить

Истории нужны одни и те же люди в каждом кадре. С POST /v1/videos/shots вы пишете, что происходит, отмечаете актёров и место — @Leo поднимает взгляд, когда @Mia_Wong садится в @[Night Café]: "Ты пришёл." — и каждый отмеченный персонаж и сцена становятся референсной картинкой. Люди сохраняют лица, волосы и одежду со своих картинок, место сохраняет свой вид, а кадр приходит со своим звуком и произнесёнными диалогами. Снимайте историю кадр за кадром, затем склеивайте кадры в одно видео бесплатно. Модель — minimax-h3-video на базе MiniMax H3, $0.13 за отрендеренную секунду с одной картинкой и $0.06 за секунду за каждую дополнительную картинку.

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

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

Make multi-character video shots with the Lovely Router video shots API and join them into one film.

- Docs (read first): https://lovelyrouter.com/docs/api/video-shots.md and https://lovelyrouter.com/docs/api/characters.md
- Save characters and scenes once (POST https://lovelyrouter.com/v1/characters, /v1/scenes), then POST https://lovelyrouter.com/v1/videos/shots with a prompt that tags them (`@handle`), `consent: true`; poll the shot until it is completed. Join finished shots with POST https://lovelyrouter.com/v1/videos/joins (free).
- Billed per rendered second plus a fee per extra picture; render one short test shot before a whole episode.
- 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 scenes and the shot list>
01

Пишите промпт как сценарий

Промпт выбирает картинки. Каждый отмеченный в нём персонаж и каждая сцена становятся одной картинкой, в порядке первого упоминания, от 1 до 9 на кадр.

Вы пишетеЭто значит
@Mia_WongПерсонаж по имени Mia Wong: пробелы становятся _, регистр не важен
@[Night Café]Любое имя ровно как написано
@chr_… или @scn_…Персонаж или сцена по id, когда у двоих одно имя
"Ты пришёл."Диалог, произносимый персонажем, отмеченным последним перед ним

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

MiniMax H3 лучше всего понимает длинный промпт из шести разделов, и писать его не нужно. Перед каждым рендером модель со зрением (rewrite_model, по умолчанию gemini-4-argon) смотрит на ваши картинки и запрос и пишет весь промпт H3; prompt_rendered показывает, что получила модель, а rewrite: false отправляет ваш собственный. Если хотите писать сами, формат разобран в гайде Как писать промпты для MiniMax H3.

Местоимения — частый способ потерять, кто есть кто, поэтому перед рендером кадра местоимения вне диалогов заменяются отметками. С одним персонажем это происходит сразу и бесплатно; с двумя и более чат-модель (sweep_model, по умолчанию gemini-3.8-flash) переписывает промпт, а результат проверяется на сохранение тех же отметок и того же диалога слово в слово. Её вызов тарифицируется как обычный чат и показывается как other_usd. Отрендеренный текст лежит в prompt_rendered, а sweep: false сохраняет ваш промпт ровно как написан.

02

От актёров до готового видео

  1. Сохраните актёров и место

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

    cURL
    curl https://lovelyrouter.com/v1/characters \
      -H "Authorization: Bearer $LOVELY_API_KEY" \
      -F name="Mia Wong" \
      -F description="A woman in her twenties with a short black bob and a yellow raincoat" \
      -F sheet=@mia-sheet.png
    
    curl https://lovelyrouter.com/v1/scenes \
      -H "Authorization: Bearer $LOVELY_API_KEY" \
      -F name="Night Café" \
      -F description="A narrow café at night, neon in the rain-streaked window" \
      -F image=@cafe.png
  2. Отрендерьте кадр

    Перечислите персонажей и сцены, которые кадр может использовать (целая библиотека — нормально), и отметьте тех, кто в нём. Кадры длятся от 5 до 15 секунд, в 16:9, 9:16 или 1:1.

    Python
    import os, requests
    
    API = "https://lovelyrouter.com/v1/videos"
    H = {"Authorization": f"Bearer {os.environ['LOVELY_API_KEY']}"}
    
    shot = requests.post(f"{API}/shots", headers=H, params={"wait": 300}, json={
        "model": "minimax-h3-video",
        "consent": True,
        "prompt": "In @[Night Café], @Leo looks up as @Mia_Wong sits down: \"You came.\"",
        "characters": ["chr_3b9e1f0c7a2d4e58b6c1a9f2", "chr_1e4b7d0a9c3f2e5b8a6d0c1f"],
        "scenes": ["scn_5b2d9e0c1a7f4b3e8d6c2a1f"],
        "seconds": 5,
        "style": "warm 35mm film",
    }).json()
    print(shot["status"], shot["rendered_seconds"], shot["url"])
  3. Склейте кадры

    Склейте от 2 до 50 готовых кадров одного размера, в порядке воспроизведения, каждый со своим звуком. Склейки бесплатны.

    Node.js
    const res = await fetch('https://lovelyrouter.com/v1/videos/joins', {
      method: 'POST',
      headers: { Authorization: `Bearer ${process.env.LOVELY_API_KEY}`, 'content-type': 'application/json' },
      body: JSON.stringify({ shots: ['shot_8c1f0a7d3b9e4c2a6f5d1e0b', 'shot_0d2e4f6a8b1c3e5d7f9a0b2c'] }),
    });
    const join = await res.json();
    console.log(join.id, join.status);

POST /v1/videos/shots отвечает 202 с объектом кадра или 200, когда кадр завершился в пределах wait (до 300 секунд). Иначе опрашивайте GET /v1/videos/shots/{id}?wait=60 и скачивайте mp4 из /content. Готовые файлы хранятся 7 дней.

03

Персонажи, говорящие своим голосом

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

04

Начните с собственной картинки

{}

Чтобы начать кадр с конкретного фрейма, отправьте изображение как сцену и скажите об этом в промпте: "Кадр открывается точно на @[Opening frame] как на первом фрейме. @Priya отворачивается от окна и идёт к камере." Открывающий фрейм следует за ним близко, но не пиксель в пиксель. Люди с фрейма из него не сохраняются; отправьте их ещё и как персонажей, если они должны выглядеть так же. Фрейм считается картинкой в цене.

05

Проекты для раскадровок

Проект хранит раскадровку: имя и ваш собственный JSON-документ до 200 КБ, и вы можете подшивать к нему кадры и склейки через project_id. Песочница хранит в одном проекте размер, стиль, язык, кадры, персонажей и сцены. Проекты бесплатны, до 100 на аккаунт.

cURL
curl https://lovelyrouter.com/v1/videos/projects \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"name": "Night café", "doc": {"size": "16:9", "shots": []}}'
06

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

Кадр тарифицируется за отрендеренную секунду. Модель рендерит по фиксированной сетке фреймов с частотой 24 fps, поэтому кадр на 5 с рендерит 5.17 с, а на 10 с — 10.13 с; об этом говорит rendered_seconds в объекте кадра.

Картинок в кадреЗа отрендеренную секунду
1$0.13
Каждая дополнительная картинка+ $0.06
3 (два персонажа и сцена)$0.25

Так что кадр в кафе выше, 5 с с двумя персонажами и сценой, стоит около $1.29. Цена резервируется при отправке и списывается при завершении кадра. Неудачные и отменённые кадры ничего не стоят, а склейки, проекты, сохранённые персонажи и сцены бесплатны. Чат-вызов переписывания промпта, когда в кадре два и более персонажа, тарифицируется как чат на том же ключе. Остальное — в тарифах.

МодельВход → выходЦена
MiniMax H3 Video (FastH3 Omni)
minimax-h3-video
text+image→video$0.13 в секунду

Актуальные цены в долларах — столько же списывает API.

Кадры подпадают под условия MiniMax H3: каждый запрос задаёт consent: true. На аккаунт может одновременно стоять в очереди или рендериться 5 кадров или склеек.

07

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

?
Сколько персонажей может быть в одном кадре?+

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

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

От 5 до 15 секунд. Склейте до 50 готовых кадров одного размера в одно длинное видео бесплатно.

Есть ли у кадра звук?+

Да. Каждый кадр приходит со своим звуком и диалогом, который вы заключили в двойные кавычки, произнесённым персонажем, отмеченным перед ним, на заданном language (по умолчанию английский).

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

$0.13 за отрендеренную секунду с одной картинкой плюс $0.06 за секунду за каждую дополнительную картинку. Склейки бесплатны, а неудачные кадры ничего не стоят.

Нужно ли сначала сохранять персонажей?+

Нет. Кадр принимает и встроенных персонажей и сцены, {name, image} с http(s) или data: URL. Сохранённые избавляют от отправки картинок каждый раз.

Чем это отличается от замены персонажа?+

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

Все поля и коды ошибок — в справочнике по видеокадрам. Для потока, который продолжается, пока вы смотрите, см. API живого видео.

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

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