Video Eraser API

от PopNow

Сотрите неподвижную область на протяжении всего клипа

popnow/video-eraser-v1/video-edit
  • Стереть область субтитров

О модели Video Eraser

Сотрите неподвижную область на протяжении всего клипа.

Вызывайте его по имени модели popnow/video-eraser-v1/video-edit через POST /jobs/createTask, от 0,024 $.

Пока это руководство есть только на английском. →

Параметры запроса

ПараметрОбязательныйОписание
mask_urlДаЗакрасьте область, которую нужно изменить.
promptНетOptional short description of the objects or area to remove and the surrounding context.
video_urlДаРолик, с которым работаем.

Цены

Цены указаны в USD. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.

ВариантUSD за секунду входного материала
Стандарт0,024 $

Длительность входного материала округляется вверх до целых секунд, минимум — 3 секунд.

До запуска отправьте то же тело запроса в POST /jobs/quote, чтобы узнать ожидаемую и максимальную стоимость в USD. Расчёт не запускает задачу и не списывает деньги.

Быстрый старт API

Вызов API Video Eraser в три шага

  1. Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
  2. Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/video-eraser-v1/video-edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
  3. Получите результат. Опрашивайте 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/video-eraser-v1/video-edit",
  "input": {
    "prompt": "Remove the subtitles inside the white mask. Preserve the rest of the video.",
    "video_url": "https://media.popnow.ai/api-examples/video-eraser/subtitles-e1128ca9.mp4",
    "mask_url": "https://media.popnow.ai/api-examples/video-eraser/subtitles-mask-b701fc56.png"
  }
}'

# 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 Eraser

Сколько стоит API Video Eraser?

Video Eraser стоит 0,024 $ за секунду. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.

Какое имя модели у Video Eraser в API?

Укажите popnow/video-eraser-v1/video-edit — Стереть область субтитров в поле model запроса POST /jobs/createTask.

Можно ли выбрать временной интервал?

Нет. Одна и та же статичная область применяется ко всему переданному клипу; полей для выбора времени нет.

Отслеживает ли маска движущиеся субтитры?

Нет. Она остаётся на фиксированных координатах кадра. Движение за пределами маски не охватывается.

Восстанавливается ли скрытое исходное изображение?

Нет. Область маски заполняется предполагаемым содержимым. Сравните движение, края и остальное изображение с источником.

Какие ограничения у API Video Eraser?

Максимальная длина входного клипа: 600 s. Запросы за пределами этих ограничений отклоняются до любого списания.

Можно попробовать Video Eraser без кода?

Запускайте Video Eraser в Playground с баланса API в USD без API-ключа. Каждый запуск сохраняется в истории разработчика с соответствующим кодом.

Ещё о Video Eraser