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

Сначала опишите, какой предмет меняется

Напишите задание человеческими словами: «заменить белую чашку на красную, оставить руку, стол и движение камеры». Обведите цель для себя на контрольном кадре. Это поможет согласовать результат с заказчиком, даже если выбранный API не принимает нарисованную маску. В таком задании важны границы изменения: новая посуда нужна внутри существующего плана, а весь интерьер переделывать не требуется.

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

Подготовьте фотографию нового товара

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

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

Проверьте руки, опору и перекрытия

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

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

Пример PixVerse Swap: режим object

В едином API Gate для PixVerse используйте model: pixverse/swap и operation: video-to-video. Тип замены находится в parameters.mode; для предмета задайте object. Ниже шаблон request.json: ссылки example.org замените прямыми доступными адресами. parameters.keyframe_id выбирает кадр, где цель хорошо видна; вход нормализуется к двадцати четырём кадрам в секунду.

Видео передаётся в video_url, фотография — в массиве image_urls. Текстовый prompt этому сценарию не нужен. keep_audio сохраняет исходную дорожку, parameters.enable_safety_checker оставляет проверку содержимого включённой. Gate самостоятельно подготовит параметры выбранного поставщика. Режим 720p допустим в текущей схеме; другой размер сначала проверяйте по схеме и оценке, не меняя требования ради более дешёвого предложения.

{
  "model": "pixverse/swap",
  "input": {
    "video_url": "https://example.org/source-product-5s.mp4",
    "resolution": "720p",
    "operation": "video-to-video",
    "image_urls": [
      "https://example.org/new-product.jpg"
    ],
    "keep_audio": true,
    "parameters": {
      "mode": "object",
      "keyframe_id": 24,
      "enable_safety_checker": true
    }
  }
}

От схемы до одного платного задания

Сначала запросите GET /v1/media/models/schema с model=pixverse/swap и operation=video-to-video. Чтение схемы не создаёт ролик. Затем оцените тот же JSON через POST /v1/media/estimate: там будут совместимый provider, причина выбора и предварительная стоимость либо null. Используется ключ Celestria Gate; отдельный секрет поставщика клиенту не нужен.

Сохраните JSON в request.json и отправьте его командой ниже. Придумайте Idempotency-Key для одного заказа. Если сеть оборвётся, повторяйте прежнее тело с прежним ключом. Другой товар — новая попытка с новым ключом. Ответ 202 возвращает media_generation и id; далее проверяйте GET /v1/media/generations/:id. Когда поставщик один, API остаётся тем же, а причина выбора сообщает об одном совместимом маршруте.

curl --fail-with-body -X POST \
  'https://api.celestriagate.com/v1/media/generations' \
  -H "Authorization: Bearer $CELESTRIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: YOUR_UNIQUE_ORDER_001' \
  --data-binary @request.json

Таблица приёмки товарного ролика

Дождитесь completed. Общий объект задания содержит result и список files; для видео смотрите result.video.url либо соответствующую ссылку в files. Тип файла может отсутствовать или быть общим, поэтому не отбрасывайте результат только из-за content_type. Получите MP4, просмотрите его целиком и сравните контрольные кадры начала, середины и конца. Провайдер и причина маршрута находятся в provider и routing.

Сначала отметьте техническое выполнение, затем соответствие рекламной задаче. Если новый предмет различим, но логотип нечитаем, это может быть подходящий черновик и неподходящий финальный материал. Решение зависит от заранее согласованных критериев, а не от статуса completed. Для клиентской версии полезно сохранить рядом исходник и результат с одинаковыми точками просмотра.

Как улучшать результат без случайных повторов

В первой попытке не меняйте одновременно фото, опорный кадр, разрешение и исходный ролик. Если результат не подходит, запишите главный дефект и измените одну причину. Например, сначала выберите кадр, где ручка чашки полностью видна; затем проверьте другую фотографию товара. Так появится объяснение результата, а не набор независимых платных дублей.

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

Цена попытки и цена пригодного результата

На 20 октября 2026 года опубликованный тариф PixVerse составляет $0,20 за короткий ролик в 720p; при длительности входа больше пяти секунд цена удваивается. Это условие поставщика, а не окончательное рублёвое списание Gate. Зафиксируйте длину исходника заранее и берите фактическую сумму из billing.cost_rub завершённого задания.

Храните исходные ссылки, JSON без ключа, идентификатор, цену и отметку «пригоден». Стоимость пригодного дубля равна всем затратам на попытки, разделённым на количество принятых роликов. Неудачное художественное решение может быть технически успешной платной генерацией. Собственного сравнительного теста PixVerse для товара мы пока не проводили; инструкция описывает проверяемый контракт и план приёмки.

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

Подойдёт ли фото нового товара на белом фоне?

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

Можно ли заменить одну из двух одинаковых чашек?

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

Зачем другой режим, если можно написать промпт?

Для PixVerse Swap текстовая инструкция не требуется. В едином API используйте pixverse/swap, operation: video-to-video и parameters.mode: object. Если нужны несколько правок по тексту, выберите подходящую модель Video Edit; путь /v1/media/generations останется тем же.

Гарантируется ли точный логотип?

Нет. В этой статье нет доказанного теста точности товарных надписей. Для коммерческого ролика проверьте видимые стороны и весь момент движения; пригодность раскадровки не означает пригодность финальной рекламы.

Источники

• PixVerse Swap: схема и режимы
• PixVerse Swap: тариф
• Единый API Gate: модели, оценка и выбор провайдера