Введение
Удаляйте фиксированную область на протяжении всего видео с помощью маски, где область удаления отмечена белым на чёрном фоне. Необязательная инструкция описывает локальное удаление; одна и та же маска применяется ко всему клипу.
| Характеристика | Значение |
|---|---|
| Ввод | Видео |
| Вывод | Видео |
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Полное видео для обработки длительностью от 1 до 600 секунд. Выбранная область обрабатывается на протяжении всего клипа. Не менее 1 символов |
mask_url | Да | Одно статичное изображение PNG, совмещённое с кадром видео. Закрасьте удаляемую область белым, а остальную — чёрным. Не менее 1 символов |
prompt | Нет | Необязательные указания для локального удаления. Они не задают временной интервал и не включают отслеживание. |
Стоимость
$0.024 / секунда
Оплачивается весь входной клип с округлением вверх до целых секунд и минимальной оплачиваемой длительностью 3 секунды. Этот эндпоинт принимает клипы длительностью от 1 до 600 секунд; размер маски не сокращает длительность.
Сценарии использования
Видео → Редактирование видео → Видео
Редактирование видео
Видео
Асинхронная задача
Руководство по промптам и практические советы
Введение
Video Eraser удаляет содержимое внутри статичной маски изображения на протяжении всего видеоклипа. Передайте video_url и mask_url, при желании добавив короткий prompt с описанием удаления. Инструмент подходит для фиксированной полосы субтитров или другого нежелательного элемента, который остаётся в одной и той же области экрана. Полученный фон представляет собой заполнение, сформированное на основе предположений, а не восстановление скрытых исходных пикселей.
Основные функции и особенности
Фиксированная область для всего клипа
Маска — это неподвижное изображение: белый цвет обозначает область для удаления, а чёрный — область для сохранения. Одна и та же область экрана применяется на протяжении всего переданного видео. Поля времени начала, поля времени окончания и управления отслеживанием движущихся объектов нет. Субтитр, вышедший за пределы белой области, не будет охвачен этой маской. Заполнение также может изменить содержимое, проходящее через выбранную область.
Необязательное описание вместе с маской
Краткое описание может уточнить, что следует удалить и что находится вокруг. Для этого эндпоинта маска остаётся обязательной, чтобы область была задана явно. Обработка оплачивается по полному входному клипу с округлением вверх до целых секунд и минимальной оплачиваемой длительностью 3 секунды. Принимаются исходные клипы длительностью от 1 до 600 секунд. Уменьшение маски не сокращает оплачиваемую длительность видео.
Сценарии использования
Удаление фиксированной полосы субтитров
Если субтитры уже встроены в изображение вашего собственного видео, отметьте полосу субтитров и проверьте все участки, где появляется текст. Статичный фон — удобная отправная точка для проверки результата. Если субтитры в проекте ещё представлены редактируемыми текстовыми слоями, удалите эти слои напрямую, прежде чем выбирать реконструкцию пикселей.
Удаление неподвижного наложения
Используйте плотно прилегающую маску для нежелательного наложения в углу видео, которое вы редактируете. Проверьте кадры, в которых человек или товар проходит позади выбранной области либо движение камеры меняет содержимое за ней. В такие моменты для заполнения приходится предполагать, как меняется содержимое, и могут проявиться мерцание или искажённые края, незаметные на одном кадре предпросмотра.
Руководство по промптам и практические советы
Создайте однозначную маску
Подготовьте PNG-маску, совмещённую с исходным кадром: белую внутри удаляемой области и чёрную снаружи. Перед отправкой проверьте положение на первом, среднем и последнем кадрах. Избегайте неоправданно больших белых областей, особенно если они перекрывают лицо или важную деталь товара. Маска статична и действует на весь клип; она не может следовать за движущимися субтитрами или ограничивать правку выбранным временным интервалом.
Опишите локальную правку и сравните результат
Необязательная инструкция, например «Удалите фиксированную полосу субтитров и заполните её окружающим фоном», описывает желаемое изменение без придумывания новой сцены. Сравните результат с оригиналом на обычной скорости воспроизведения, а вблизи сложных движений — также покадрово. Помимо удалённой области проверьте участки вне маски, длительность клипа, частоту кадров и звук. Сохранение исходного звука и точное сохранение пикселей за пределами маски не проверены, поэтому сохраните исходный файл.
Быстрый старт 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/video-eraser-v1/video-edit",
"input": {
"mask_url": "https://example.com/reference.png",
"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.