О модели 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 в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
- Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/video-eraser-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/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-ключа. Каждый запуск сохраняется в истории разработчика с соответствующим кодом.