Введение
Выделите передний план существующего клипа и выберите прозрачный или однотонный фон. По умолчанию запрашивается прозрачный WebM VP9 с исходным звуком.
| Характеристика | Значение |
|---|---|
| Ввод | Видео |
| Вывод | Видео |
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Исходный клип длительностью от 1 до 60 секунд. В результате выделяется обнаруженный передний план; управление кадрированием не предусмотрено. Не менее 1 символов |
background | Нет | Выберите прозрачность или один из десяти однотонных цветов. Для прозрачного результата нужен формат с поддержкой альфа-канала. |
output_format | Нет | Пресет контейнера и кодека. По умолчанию используется WebM VP9. |
keep_original_audio | Нет | Запрашивает исходный звук в результате; включено по умолчанию. Отключите для получения клипа без звука. По умолчанию: |
Стоимость
$0.06 / секунда
Оплата за каждую секунду входного видео с округлением вверх до целой секунды. Этот эндпоинт принимает клипы длительностью от 1 до 60 секунд. Выбор фона, формата и звука не меняет это правило расчёта по длительности.
Сценарии использования
Видео → Редактирование видео → Видео
Редактирование видео
Видео
Асинхронная задача
Руководство по промптам и практические советы
Введение
Инструмент удаления фона видео выделяет передний план существующего видео для композитинга или размещения на однотонном фоне. Отправьте video_url и выберите фон и формат экспорта. Запрос по умолчанию предусматривает прозрачный WebM VP9 и сохранение исходного звука. Этот эндпоинт принимает исходные клипы длительностью от 1 до 60 секунд; он не создаёт новую сцену по текстовому запросу.
Основные функции и особенности
Прозрачность определяется выбором фона и формата
Задайте для background значение transparent и используйте формат с поддержкой альфа-канала. WebM VP9, MOV ProRes 4444, MKV VP9 и GIF указаны в документации как варианты с поддержкой альфа-канала. Здесь пресеты MP4 и пресеты MKV H.264 или H.265 не содержат альфа-канал; несовместимые запросы прозрачности могут быть отклонены. Для MOV H.265 документирована лишь частичная поддержка, поэтому в стандартном процессе работы с прозрачностью используйте WebM VP9 и проверяйте фактический результат перед композитингом.
Однотонные цвета и исходный звук
Вместо прозрачности можно выбрать чёрный, белый, серый, красный, зелёный, синий, жёлтый, циан, пурпурный или оранжевый цвет. keep_original_audio определяет, запрашивается ли исходный звук в результате. GIF не может содержать звуковую дорожку; при его выборе отключайте сохранение звука. Выбор контейнера, кодека и фона не меняет правило оплаты по длительности. Для расчёта используются секунды входного видео с округлением вверх; управление кадрированием или выходным разрешением в этом эндпоинте не предусмотрено.
Варианты использования
Разместить ведущего поверх презентации
Начните с короткого клипа, в котором ведущий чётко отделён от фона. Запросите прозрачный WebM VP9, затем разместите результат поверх слайда или сцены в редакторе с поддержкой этого формата. Перед публикацией композиции проверьте волосы и размытые движением края как на тёмном, так и на светлом фоне.
Подготовить клип с товаром для нового макета
Отделите товар от исходного окружения, чтобы повторно использовать видеоматериал в макете каталога или монтаже для социальных сетей. Экспорт с однотонным фоном может пригодиться, если прозрачность не нужна. Отражающие поверхности и тонкие края требуют внимательной проверки: результат представляет собой обработанную маску, и оценивать его следует на предполагаемом фоне, а не только в предпросмотре с шахматной сеткой.
Руководство по запросам и практические советы
Осознанно выбирать формат конечного файла
Для стандартного видеопроцесса оставьте background=transparent, output_format=webm_vp9 и keep_original_audio=true. Выбирайте другой пресет только после проверки того, что ваш редактор может его импортировать. Поддержка воспроизведения в интернете зависит от браузера и кодека; успешная загрузка не доказывает, что встроенный предпросмотр или последующее редактирование будут работать. Сохраняйте прозрачный мастер-файл, создавая отдельную сведённую с фоном версию для предпросмотра и отправки другим.
Проверять прозрачность и весь клип
Проверьте фактический альфа-канал и скомпонуйте результат с чёрным, белым и насыщенным цветным фоном. Отображение шахматной сетки или чёрного прямоугольника в файле не доказывает, что прозрачность работает. Просмотрите всё движение, отслеживая изменения краёв, и сравните длительность, размеры кадров и синхронизацию звука с оригиналом. Не делайте вывод о наличии альфа-канала по имени файла или выбранным параметрам. Для этой интеграции ещё не завершены испытания качества медиа или совместимости с браузерами; проверьте результат в предполагаемом рабочем процессе.
Быстрый старт 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-v1/video-edit",
"input": {
"background": "transparent",
"output_format": "webm_vp9",
"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.
