Введение
Что делает этот эндпоинт
Он отделяет главный объект видео от всего, что находится позади, без хромакея и без шага выделения. Волосы, шерсть и свободная ткань сохраняют мягкие края.
Важные входные данные
video_url принимает один ролик длиной не более 120 секунд. output_format задаёт результат: mp4, webm или matte. С mp4 можно добавить background_image_url или background_video_url. resolution — 480p или 720p.
Что вы получите
Одно видео с соотношением сторон и длиной исходника и с исходным звуком.
| Характеристика | Значение |
|---|---|
| Ввод | Видео |
| Вывод | Видео |
| Эндпоинт | Редактирование видео |
| Вход | Одно видео до 120 секунд |
| Фон | Ваше изображение или видео (только mp4); без него — белый |
| Результаты | MP4, прозрачный WebM (альфа VP9) или чёрно-белая маска в MP4 |
| Разрешение | 480p или 720p, соотношение сторон исходника сохраняется |
| Оплата | Секунды исходника × тариф выбранного разрешения; минимум 3 с |
Ключевые возможности и особенности
С террасы у моря на городскую крышу
Мы взяли 5-секундный ролик с женщиной на террасе над морем и отправили фоном видео крыши на закате. Она вернулась уже на крыше: длинные волосы по-прежнему лежали отдельными прядями, фон позади неё двигался, а звук ролика остался нетронутым. Неподвижное изображение работает так же; без фона MP4 возвращается на белом.
Чёрно-белая маска для собственного композитинга
Вариант matte — это MP4, где объект белый, а всё остальное чёрное, той же длины и с той же частотой кадров, что и исходник. Совместите его с оригиналом в редакторе, который умеет работать с яркостным ключом.
WebM с настоящим альфа-каналом
Выберите webm, чтобы получить файл VP9 с прозрачным фоном, который можно сразу положить поверх геймплея, слайдов или другого кадра. Chrome, Edge и Firefox показывают прозрачность; Safari воспроизводит тот же файл на чёрном.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Ролик для обработки: загруженный MP4 или WebM либо прямая ссылка на файл, не длиннее 120 секунд. Более длинный ролик отклоняется до обработки и не оплачивается. Не менее 1 символов |
output_format | Нет | mp4 (по умолчанию) возвращает объект на вашем фоновом изображении или видео либо на белом. webm возвращает VP9 с прозрачностью (Safari показывает на чёрном). |
background_image_url | Нет | Необязательно: JPEG, PNG или WebP позади объекта, масштабируется на весь кадр. Только при |
background_video_url | Нет | Необязательно: MP4 или WebM позади объекта, масштабируется на весь кадр и зацикливается, если короче ролика. Только при |
resolution | Нет | Размер вывода: 480p или 720p (по умолчанию). Соотношение сторон исходника сохраняется. |
Стоимость
Оплата посекундная по длине исходного ролика и тарифу выбранного разрешения, с округлением до целой секунды вверх и минимумом 3 секунды. Ролики длиннее 120 секунд отклоняются при отправке. Формат вывода и фон на цену не влияют. Неудачные запросы не оплачиваются.
| Спецификация | Стоимость |
|---|---|
| $0.024 / секунду |
| $0.048 / секунду |
Сценарии использования
Ведущий на фирменном фоне
Поставьте человека, снятого в обычной комнате, перед студийной картинкой или зацикленным видеофоном — без хромакея и пересъёмки.
Наложения для монтажа и стримов
Прозрачный WebM с танцовщицей, питомцем или товаром ляжет поверх геймплея, слайдов или другого кадра в любом редакторе, который читает альфу VP9.
Дорожки ключа для композитинга
Вариант matte даёт чистую чёрно-белую дорожку, которую можно совместить с оригиналом в After Effects, DaVinci Resolve или в конвейере в духе Nuke.
Руководство по промптам и практические советы
Загрузите ролик с одним чётким объектом
Объект определяется автоматически: ни промпта, ни выделения кликом. Чище всего вырезается один человек или предмет перед камерой. Ролик может длиться до 120 секунд.
Выберите, что хотите получить
mp4 — готовый кадр на новом фоне, webm — если нужна прозрачность, matte — если редактор ждёт дорожку ключа. Фоновое изображение или видео используется только с mp4.
Проверьте в 480p, сдайте в 720p
Оба размера сохраняют соотношение сторон исходника. Секунда в 720p стоит вдвое дороже, чем в 480p, поэтому сначала проверьте вырезку на коротком прогоне в 480p.
Введение
Video Background Remover Pro берёт обычный ролик, находит человека или предмет перед камерой и отделяет его от сцены. Что вернётся, решаете вы: объект на новом фоне, один объект на прозрачности или чёрно-белая маска для ключа в вашем редакторе.
Запрос
{
"video_url": "https://example.com/beach.mp4",
"background_video_url": "https://example.com/city-lights.mp4",
"output_format": "mp4",
"resolution": "720p"
}
Обязателен только video_url. По умолчанию output_format — mp4, resolution — 720p. Передавайте не больше одного из background_image_url и background_video_url, и только с mp4; без них объект ставится на белый фон.
Три варианта вывода
mp4: готовый кадр. Фоновое изображение масштабируется на весь кадр; фоновое видео — тоже, и оно зацикливается, если короче вашего ролика.webm: VP9 с альфа-каналом. Chrome, Edge и Firefox показывают его прозрачным; Safari воспроизводит на чёрном.matte: MP4, где объект белый, а всё остальное чёрное, покадрово совпадающий с исходником.
Что мы увидели в тестах
Мы взяли 3-секундный пляжный ролик 16:9: женщина с развевающимися волосами на фоне низкого солнца. В 480p каждый вариант вернулся в 854×480 при 24 к/с, в 720p — в 1280×720; обработка занимала примерно одну-две минуты на ролик. Более широкий ролик с террасой 2:1 вернулся в 906×452 при 25 к/с: размер определяется числом пикселей выбранного режима, а не фиксированной высотой, и частота кадров исходника сохраняется. Тонкие пряди в маске остались раздельными, WebM декодировался с настоящим альфа-каналом, а в версиях MP4 сохранился исходный звук. Ролик длиной 2 секунды был оплачен как 3 секунды — это минимум.
Ход задачи
Вызов асинхронный: создайте задачу, опрашивайте её до завершения, затем скачайте видео из хранилища SpicyAPI. Неудачные запросы не оплачиваются.
Советы
- Перед загрузкой обрежьте ролик до нужного фрагмента: оплата идёт по длине исходника.
- Лучше всего работает один чёткий объект. Если в кадре несколько человек, инструмент сам решает, кто из них объект.
- Если прозрачность должна быть видна и в Safari, используйте вместо WebM маску вместе с исходным роликом.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/background-remover-video-pro/video-edit",
"input": {
"output_format": "mp4",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.



