API видеокадров для сцен с несколькими персонажами
Пишите кадр как строку сценария, отмечайте персонажей и места через @ и получайте видео со звуком и диалогами. Склейка кадров в фильм бесплатна.
Обновлено 2026-11-05
Бонус за пополнение: Чёрная пятница
Каждое подходящее пополнение даёт бесплатные средства, а также суммируется с другими предложениями.
До 30 ноября
Истории нужны одни и те же люди в каждом кадре. С 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>
Пишите промпт как сценарий
Промпт выбирает картинки. Каждый отмеченный в нём персонаж и каждая сцена становятся одной картинкой, в порядке первого упоминания, от 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 сохраняет ваш промпт ровно как написан.
От актёров до готового видео
Сохраните актёров и место
Сохранённый персонаж — это имя, описание и лист поворотов: тот же человек с четырёх сторон и крупные планы шести выражений. Сделайте лист через API изображений и сохраните его прямо из задачи изображения с помощью
sheet_image_job. Сцена — это место и его картинка. И то и другое бесплатно, до 100 каждого на аккаунт.cURLcurl 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Отрендерьте кадр
Перечислите персонажей и сцены, которые кадр может использовать (целая библиотека — нормально), и отметьте тех, кто в нём. Кадры длятся от 5 до 15 секунд, в
16:9,9:16или1:1.Pythonimport 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"])Склейте кадры
Склейте от 2 до 50 готовых кадров одного размера, в порядке воспроизведения, каждый со своим звуком. Склейки бесплатны.
Node.jsconst 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 дней.
Персонажи, говорящие своим голосом
Дайте персонажу сохранённый голос (voice_id) или загрузите образец при его сохранении, и его реплики в кадре будут произнесены им: его тембром, высотой и манерой, а не его словами. Первые 3 озвученных персонажа кадра, в порядке появления в картинке, приносят свои голоса; остальных озвучивает модель. Голос можно и спроектировать: опишите его в синтезе речи, сохраните результат и привяжите. Голоса не меняют цену.
Начните с собственной картинки
Чтобы начать кадр с конкретного фрейма, отправьте изображение как сцену и скажите об этом в промпте: "Кадр открывается точно на @[Opening frame] как на первом фрейме. @Priya отворачивается от окна и идёт к камере." Открывающий фрейм следует за ним близко, но не пиксель в пиксель. Люди с фрейма из него не сохраняются; отправьте их ещё и как персонажей, если они должны выглядеть так же. Фрейм считается картинкой в цене.
Проекты для раскадровок
Проект хранит раскадровку: имя и ваш собственный JSON-документ до 200 КБ, и вы можете подшивать к нему кадры и склейки через project_id. Песочница хранит в одном проекте размер, стиль, язык, кадры, персонажей и сцены. Проекты бесплатны, до 100 на аккаунт.
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": []}}'Сколько вы платите
Кадр тарифицируется за отрендеренную секунду. Модель рендерит по фиксированной сетке фреймов с частотой 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 кадров или склеек.
Частые вопросы
Сколько персонажей может быть в одном кадре?+
До 9 картинок на кадр, считая персонажей и сцены вместе. До 3 озвученных персонажей приносят свои голоса; остальных озвучивает модель.
Какой длины может быть кадр?+
От 5 до 15 секунд. Склейте до 50 готовых кадров одного размера в одно длинное видео бесплатно.
Есть ли у кадра звук?+
Да. Каждый кадр приходит со своим звуком и диалогом, который вы заключили в двойные кавычки, произнесённым персонажем, отмеченным перед ним, на заданном language (по умолчанию английский).
Сколько стоит видеокадр?+
$0.13 за отрендеренную секунду с одной картинкой плюс $0.06 за секунду за каждую дополнительную картинку. Склейки бесплатны, а неудачные кадры ничего не стоят.
Нужно ли сначала сохранять персонажей?+
Нет. Кадр принимает и встроенных персонажей и сцены, {name, image} с http(s) или data: URL. Сохранённые избавляют от отправки картинок каждый раз.
Чем это отличается от замены персонажа?+
Замена персонажа помещает нового человека в клип, который у вас уже есть. Кадры создают видео с нуля, из промпта и картинок. Чтобы переснять существующее видео, см. замену персонажа.
Все поля и коды ошибок — в справочнике по видеокадрам. Для потока, который продолжается, пока вы смотрите, см. API живого видео.
Один предоплаченный ключ для моделей, данных и агентов
Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.