Замена персонажа в видео по фото через API: подготовка и проверка

Определите, что именно нужно заменить

Фраза «заменить человека» допускает несколько результатов. Заказчик может иметь в виду только лицо, всю фигуру с одеждой или нового героя в похожей сцене. Уточните это до выбора модели. Для полной замены запишите, что внешний вид и костюм берутся из фотографии, а ходьба, время, камера и окружение остаются из видео. Такой список становится критериями приёмки.

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

Выберите простой исходный фрагмент

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

Сохраните реальную длительность и частоту кадров исходника. Эти значения нужны для стоимости и сопоставления движений. После обрезки убедитесь, что файл действительно заканчивается на нужной секунде: большой исходник с просьбой «используй пять секунд» не равен заранее подготовленному короткому ролику. Для знакомого сценария прогулки можно начать с пяти секунд и двадцати четырёх кадров в секунду.

Подберите фотографию с нужной внешностью

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

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

Выберите замену, а не случайно похожий режим

Для сохранения исходного окружения рассматривайте Swap, Replace или Video Edit. Motion Control полезен для переноса движения на героя фотографии, но сцену может определять само фото. Image to Video создаёт движение на основе изображения и не обязан повторить готовую прогулку. Название семейства не заменяет проверку конкретной операции и входных полей.

PixVerse Swap задаёт режим person и принимает одну фотографию. Kling O1 Edit позволяет дополнительно описать, какие элементы надо изменить и сохранить. Wan Animate Replace также относится к замене персонажа, но его цена зависит от кадров. Сравнивать качество вариантов следует на одинаковых материалах; собственного параллельного испытания всех трёх моделей у нас нет.

Сформулируйте запрос из трёх частей

В тексте Kling назовите исходную цель, затем замену и затем ограничения. Например: «замени главного идущего человека персонажем с первого фото, включая одежду; сохрани шаги, фон и камеру». Уберите противоречия вроде «сохрани одежду» рядом с «замени весь костюм». Не просите одновременно менять время суток и доказывать, что свет остался прежним.

Ниже запрос единого API: kwaivgi/kling-video-o1, операция video-to-video. Замените ссылки example.org своими адресами и адаптируйте prompt к материалам. image_urls — массив даже для одного фото. Звук отключён осознанно. duration и resolution отсутствуют: длительность задаёт подготовленный вход, а размер нельзя назначать выдуманным параметром. Проверка содержимого, если нужна, задаётся внутри parameters.

{
  "model": "kwaivgi/kling-video-o1",
  "input": {
    "video_url": "https://example.org/source-walking-5s.mp4",
    "image_urls": [
      "https://example.org/new-character.jpg"
    ],
    "prompt": "Replace the main walking person in @Video1 with the person from @Image1, including appearance and clothing. Preserve the walking motion, camera, park background and lighting. Do not transfer the pose or background from the photo.",
    "keep_audio": false,
    "operation": "video-to-video",
    "parameters": {
      "enable_safety_checker": true
    }
  }
}

Отправьте материалы и сохраните одну попытку

Используйте ключ Gate и сначала получите схему /v1/media/models/schema с model=kwaivgi/kling-video-o1 и operation=video-to-video. Затем отправьте тот же JSON в /v1/media/estimate без платной генерации. Gate проверит совместимость поставщиков и покажет причину решения. Если цена неизвестна, null не означает бесплатный заказ. Платное создание выполняется в /v1/media/generations.

Перед созданием проверьте прямые ссылки на оба файла. Ответ возвращает object: media_generation и id. Сохраните ID, JSON и Idempotency-Key, затем проверяйте /v1/media/generations/:id. Пока задача в очереди, выполняется или ожидает billing, новая отправка не нужна. При сетевом обрыве восстанавливайте прежний заказ с тем же телом и ключом. Изменение фото или инструкции — отдельная творческая попытка.

Как проверить лицо, фигуру и движение

Сначала посмотрите исходник и результат рядом на обычной скорости. Человек должен оставаться одним персонажем, одежда — сохранять форму, шаги — не перескакивать. Затем сравните начало, середину и конец. При повороте головы проверьте промежуточные кадры, а не только фронтальный портрет. Для лица отдельно оцените геометрию глаз, линию волос и устойчивость черт между моментами.

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

Запишите результат и стоимость одной попытки

В нашем тесте 20 октября 2026 года человек в парке заменён женщиной в жёлтом платье; движение и окружение сохранились. Для пятисекундного исходника Kling O1 Pro через fal подтвердил расход $0,84, Gate списал 93,79 ₽. Лицо было со спины: точность лица этим опытом не проверена. Реальные кадры находятся в основном руководстве по замене объекта.

Для своей попытки сохраните ID, исходники, JSON без секрета и окончательный billing. Сначала исправляйте один недостаток: другую фотографию, более ясную инструкцию или более простой фрагмент. Так можно связать результат с изменением. Даже технически успешный ролик может потребовать ручной доработки; учитывайте её при расчёте стоимости пригодного результата и согласовании срока с клиентом.

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

Хватит ли одного портрета для полной замены человека?

Пример принимает одно фото, но портрет не описывает весь костюм и фигуру. Если важны одежда и обувь, подберите снимок, где они видны. Недостающие детали модель может придумать.

Почему модель перенесла позу с фотографии?

Уточните инструкцию и режим. Для редактирования важно явно сохранять движение исходного ролика и брать из фото внешность. Motion Control и обычное оживление фото имеют другой смысл.

Можно обещать узнаваемое лицо по тесту со спины?

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

Как показать фото, переданное ссылкой?

В обычном чате Gate фото из соответствующего параметра отображается в отправленном сообщении. До отправки проверьте доступность ссылки, после — фото в сообщении. В API фото передаётся в поле модели, а не только упоминается словами.

Источники

• Kling O1 Edit: схема
• PixVerse Swap: схема
• Wan Animate Replace
• Общий маршрут Gate