Удалить фон видеоО модели Video Background Remover
Прозрачный видеомастер для вашей следующей композиции.
Вызывайте его по имени модели popnow/background-remover-video-v1/video-edit через POST /jobs/createTask, от 0,06 $.
Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
background | Нет | Оставить, убрать или заменить фон. transparent · black · white · gray · red · green · blue · yellow · cyan · magenta · orange · По умолчанию: transparent |
keep_original_audio | Нет | Keep the source audio in an output format that supports audio. GIF does not carry sound. По умолчанию: true |
output_format | Нет | Формат файла результата. webm_vp9 · mp4_h264 · mp4_h265 · mov_h265 · mov_proresks · mkv_h264 · mkv_h265 · mkv_vp9 · gif · По умолчанию: webm_vp9 |
video_url | Да | Ролик, с которым работаем. |
Цены
Цены указаны в USD. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.
| Вариант | USD за секунду входного материала |
|---|---|
| Стандарт | 0,06 $ |
Длительность входного материала округляется вверх до целых секунд, минимум — 1 секунд.
До запуска отправьте то же тело запроса в POST /jobs/quote, чтобы узнать ожидаемую и максимальную стоимость в USD. Расчёт не запускает задачу и не списывает деньги.
Быстрый старт API
Вызов API Video Background Remover в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
- Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/background-remover-video-v1/video-edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/background-remover-video-v1/video-edit",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Video Background Remover
Сколько стоит API Video Background Remover?
Video Background Remover стоит 0,06 $ за секунду. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.
Какое имя модели у Video Background Remover в API?
Укажите popnow/background-remover-video-v1/video-edit — Удалить фон видео в поле model запроса POST /jobs/createTask.
Какие настройки запрашивают прозрачный результат?
Используйте background=transparent вместе с output_format=webm_vp9. Сохраните полученный мастер-файл с альфа-каналом для композитинга и проверьте фактический канал перед использованием.
Можно ли сохранить звук в GIF?
Нет. У GIF нет звуковой дорожки. Отключайте keep_original_audio при запросе GIF.
Можно ли считать, что результат работает во всех браузерах?
Нет. Поддержка контейнеров и кодеков различается. Проверьте воспроизведение и редактирование в том браузере или приложении, где будет использоваться результат.
Какие ограничения у API Video Background Remover?
Максимальная длина входного клипа: 60 s. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Video Background Remover без кода?
Запускайте Video Background Remover в Playground с баланса API в USD без API-ключа. Каждый запуск сохраняется в истории разработчика с соответствующим кодом.
