API генерации музыкальных клипов:
на входе песня, на выходе клип
Отправьте песню и короткое описание и получите mp4, смонтированный в ритм, с одним и тем же исполнителем в каждой сцене и вашим треком в качестве звука.
Раньше музыкальный клип означал съёмки, монтажёра и бюджет. Теперь ИИ-генератор клипов справляется за один вызов API: POST /v1/videos/music принимает вашу песню и короткое описание (сюжет, визуальный стиль, исполнитель) и возвращает один mp4 длиной в песню. Сцены смонтированы в ритм, в каждой из них один и тот же исполнитель, который поёт текст под фонограмму, а звуковая дорожка — ваш оригинальный трек без изменений. Встройте это в музыкальное приложение, в процесс релизов лейбла или в инструмент для авторов либо сделайте клип в Песочнице без единой строчки кода.
Передайте это своему ИИ-агенту
Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.
Make a music video from a song with the Lovely Router music video API: it cuts the song on the beat into scenes, casts one singer, renders every scene with the song driving the picture and joins them into one mp4 over the original track. - Docs (read first): https://lovelyrouter.com/docs/models/music-videos.md and https://lovelyrouter.com/docs/api/music-videos.md - Start: POST https://lovelyrouter.com/v1/videos/music (multipart) with `song` (MP3/WAV/FLAC/OGG/M4A, up to 60 MB), `model` (`ltx-music-video`, or `minimax-h3-music-video` for the steadiest likeness), `size` (`16:9`, `9:16` or `1:1`), an optional brief (`story`, `style`, `character`, `locations`, `lyrics`) and `consent=true` (accepts the model's terms; read the licence linked in the docs first and tell me if my use might not be allowed). - It answers 202 at once. Poll GET https://lovelyrouter.com/v1/videos/music/<id>?wait=120 until `status` is `completed`, `failed` or `cancelled`, then download GET https://lovelyrouter.com/v1/videos/music/<id>/content (kept 7 days). - Billed per second of the song (at least 15 s), plus the director's chat calls and the character pictures. Once started it can't be stopped: send `auto_render: false` to stop at `ready`, show me the character sheets and scene prompts, and only call POST .../render after I approve. Use `start`/`end` (seconds) to make it for part of the song. - For a recurring artist, save them once with POST https://lovelyrouter.com/v1/characters (docs: https://lovelyrouter.com/docs/api/characters.md) and pass `character_id`. - 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 song file, what the video should show (story, style, singer) and the aspect ratio>
Как это работает
Отправьте песню и описание
Загрузите файл MP3, WAV, FLAC, OGG или M4A (до 60 МБ) и при желании
story,style,characterиlyrics. Все поля необязательны: без описания режиссёр сам придумает сюжет и исполнителя по тексту песни.Монтаж в ритм, кастинг один раз
Песня делится на сцены, которые заканчиваются на сильных долях, примерно по 5 секунд, а текст расшифровывается по сценам. Чат-модель в роли режиссёра один раз описывает исполнителя, а модель изображений рисует для каждого образа лист персонажа (анфас, профиль, со спины), поэтому во всех сценах один и тот же человек.
Режиссура и рендер сцена за сценой
Режиссёр пишет для каждой сцены кадр по вашему описанию и её фрагменту текста, с движением камеры и светом. Каждая сцена рендерится под управлением своего фрагмента песни: губы исполнителя следуют за словами, а движение — за музыкой.
Один mp4 под ваш трек
Сцены склеиваются по порядку поверх оригинальной песни. Каждый клип можно смотреть сразу после рендера, а готовое видео доступно для скачивания 7 дней.
Клип одним запросом
curl https://lovelyrouter.com/v1/videos/music \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-F model=ltx-music-video \
-F song=@song.mp3 \
-F story="A night drive through a neon city; she leaves the old town behind and reaches the sea at dawn" \
-F style="Cinematic 35 mm film, teal and orange, light rain, shallow depth of field" \
-F character="A woman in her twenties with short black hair, a red leather jacket and silver hoop earrings" \
-F size=16:9 \
-F consent=trueЗапрос сразу отвечает 202 с объектом музыкального клипа. Опрашивайте GET /v1/videos/music/{id}?wait=120, чтобы узнать status, progress и состояние сцен, а когда статус станет completed, скачайте результат через GET /v1/videos/music/{id}/content. В руководстве по музыкальным клипам тот же процесс показан на Python и Node.js.
Инструменты для этой задачи
POST /v1/videos/music выполняет весь конвейер: анализ ритма, кастинг, листы персонажей, режиссуру, рендер и финальный монтаж. Доступны форматы 16:9, 9:16 и 1:1. Справочник: API музыкальных клипов.
Сохраните артиста один раз через POST /v1/characters (имя, описание и лист персонажа) и передавайте character_id в каждом видео — одно и то же лицо пройдёт через весь альбом. Сохранение бесплатно. Подробнее — в разделе персонажи.
Передайте start и end в секундах, чтобы сделать видео только для припева или первой минуты. Вы платите за фрагмент, а не за всю песню. В Песочнице есть нарезка с предпросмотром.
С auto_render: false задача останавливается, когда у каждой сцены готовы промпт и первый кадр. Перепишите любую сцену через PATCH, затем вызовите POST …/render. Отклонённый план ничего не стоит за видео.
Рисуются API генерации изображений на вашем ключе — по фото исполнителя (character_image) или по описанию. Модель изображений выбирается параметром image_model.
director_model принимает любую чат-модель, доступную вашему ключу; быстрой и недорогой вполне достаточно.
Две модели
| Модель | Цена за секунду песни | Для чего лучше |
|---|---|---|
ltx-music-video | $0.06 | Быстрый рендер, около 20–25 с на сцену: 3-минутная песня примерно за 12–15 минут. До 1472×832. |
minimax-h3-music-video | $0.13 ($0.2 с first_frames) | Исполнитель снимается прямо по листу персонажа — самое стабильное сходство, около 45 с на сцену. До 1344×768. |
Обе модели принимают песни от 5 секунд до 6 минут, тарифицируют не меньше 15 секунд и рендерят с частотой 24 кадра/с. В каждом запросе нужно указать consent: true, чтобы принять условия модели: условия LTX или условия MiniMax H3, которые не разрешают использование в ЕС, Великобритании, Южной Корее и США.
Рецепты
Сохраните артиста через POST /v1/characters, затем вызывайте API с character_id и сюжетом в одну строку для каждого сингла. В каждом видео — одно и то же лицо.
Передайте size=9:16 с start и end вокруг хука и получите вертикальное видео на 15–60 секунд для Reels, Shorts или TikTok.
Установите auto_render: false, покажите пользователю листы персонажей и первые кадры, дайте ему переписать сцены и только потом запускайте рендер.
Показывайте клип каждой сцены (scenes[n].url) по мере рендера.
Передайте lyrics в исходном виде и language (например, en, zh или ja) — режиссёр процитирует нужные слова в каждом кадре с исполнением.
Сколько это стоит
Вы платите за секунду песни: $0.06 с ltx-music-video, так что песня на 3½ минуты стоит $12.6; $0.13 с minimax-h3-music-video. Вызовы режиссёра и изображения персонажей (обычно по одному на образ плюс по одному на сцену) оплачиваются отдельно по ценам этих моделей. Когда длина песни известна, её стоимость резервируется на предоплаченном балансе, а видео рассчитывается одним списанием в логах. Если видео не получилось по нашей вине, плата за него не взимается. Цены всех моделей — на странице цен.
Права и ответственное использование
Используйте песни, которые принадлежат вам или на которые у вас есть права, и людей, которых вам разрешено изображать. Видео должны соответствовать условиям модели и Правилам допустимого использования. Готовые видео хранятся 7 дней, затем удаляются; скачайте то, что хотите сохранить.
Частые вопросы
Нужно ли предоставлять музыку?+
Да. Видео строится вокруг вашей песни: её ритм задаёт монтажные склейки, текст управляет пением, а готовый mp4 использует её как звуковую дорожку. Отправьте целую песню длиной до 6 минут или фрагмент более длинной.
Исполнитель будет выглядеть одинаково во всех сценах?+
Да, по умолчанию. Исполнитель выбирается один раз и рисуется как лист персонажа для каждого образа, и каждая сцена начинается с этого листа. Чтобы выбрать лицо самостоятельно, отправьте фото как character_image или character_id сохранённого персонажа.
Сколько времени занимает создание клипа?+
Анализ занимает меньше минуты, листы персонажей — несколько минут. Затем сцены рендерятся одна за другой: 3-минутная песня занимает около 12–15 минут с ltx-music-video и 25–30 минут с minimax-h3-music-video. Если прогретого GPU нет, добавьте около полутора минут.
Можно ли отредактировать сцены перед рендером?+
Да. Передайте auto_render: false, и задача остановится в статусе ready с промптом и первым кадром для каждой сцены. Перепишите сцены через PATCH, затем запустите рендер через POST /v1/videos/music/{id}/render. Отклонённый план бесплатен.
Какие соотношения сторон доступны?+
16:9 для YouTube, 9:16 для вертикальных платформ коротких видео и 1:1 для лент. Все видео рендерятся с частотой 24 кадра в секунду.
Может ли ИИ-агент делать музыкальные клипы за меня?+
Да. Скопируйте промпт с этой страницы в Claude Code, Cursor или Codex: он направит агента к документации в Markdown, и агент вызовет API с вашим ключом.
Для статичных изображений смотрите API генерации изображений; все эндпоинты и поля описаны в справочнике API музыкальных клипов.
Один предоплаченный ключ для моделей, данных и агентов
Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.