API замены персонажей с ИИ:
замените людей в любом видео

1. Загрузите видео

   Отправьте файл MP4, MOV или WebM (до 95 МБ) на POST /v1/videos/replacements — или только нужный фрагмент длиной до 3 минут. Видео разбивается на кадры, а все люди в нём группируются в состав (p1, p2, …) с портретом, поясным изображением и списком кадров, где они появляются. Этот анализ бесплатный.

2. Укажите, кто кем станет

   Сопоставьте каждому участнику состава персонажа: character_id сохранённого персонажа, картинку или keep. Выберите person, чтобы заменить человека целиком (лицо, волосы, тело и одежду), или face, чтобы заменить только голову и оставить одежду. Сохраните исходные фоны или задайте background: "new" и опишите новую сцену scene для каждого кадра.

3. Кадр за кадром, остальное не трогаем

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

4. Одно видео, тот же звук

   Кадры склеиваются в исходном порядке поверх оригинального звука. Смотрите каждый заменённый фрагмент сразу после готовности, перезапускайте фрагменты, где кого-то пропустили, и скачивайте готовый mp4 в течение 7 дней.

# 1. Upload: shots and cast are found for free
curl https://lovelyrouter.com/v1/videos/replacements \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -F model=minimax-h3-character-swap \
  -F video=@party.mp4 -F start=12 -F end=72 \
  -F consent=true

# 2. Render: p1 becomes your saved character, p2 stays
curl https://lovelyrouter.com/v1/videos/replacements/RPL_ID/render \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"cast": {"p1": {"character_id": "chr_3b9e1f0c7a2d4e58b6c1a9f2"}, "p2": "keep"}, "mode": "person"}'

Загрузка отвечает 202; опрашивайте GET /v1/videos/replacements/{id}?wait=60, пока статус не станет ready, и прочитайте поля shots и cast. После вызова рендера снова опрашивайте до статуса succeeded, затем скачайте результат через GET /v1/videos/replacements/{id}/content. В справочнике по замене в видео тот же процесс показан на Python.

60-секундное видео, в котором ваш персонаж появляется на 25 секунд, стоит около $5. Максимально возможная стоимость рендера резервируется на предоплаченном балансе при старте, а остаток возвращается по завершении; кадр, в котором не нашлось ни одного сопоставленного человека, не оплачивается. Заметки модели зрения о каждом персонаже и проверка говорящего в каждом кадре списываются как небольшие чат-вызовы по вашему ключу. Все цены — на странице цен.

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