Video Eraser API reference
Erase a fixed region across your clip
Call Video Eraser from your own code with one PopNow API key. Below are the exact model IDs to send, every input field the model accepts, what each request costs in USD, and a request you can paste into a terminal.
At a glance
- Made by
- PopNow
- Output
- Video
- From
- $0.024 USD per input second
- Model IDs
Prices are in USD, charged to your separate API wallet. A task reserves the maximum possible charge when accepted and settles actual usage on completion; any remainder is released. Failed tasks are not charged. Call POST /api/v1/jobs/quote for an exact quote before running.
Erase subtitle area
popnow/video-eraser-v1/video-edit
Price
| Option | USD |
|---|---|
Default | $0.024 per input second |
Input duration is rounded up to whole seconds, with a 3-second minimum.
Parameters
| Field | Type | Default | Allowed | What it does |
|---|---|---|---|---|
video_urlRequired | string | — | — | Source clip, from 1 to 600 seconds. The static mask applies throughout the complete clip. |
mask_urlRequired | string | — | — | Static PNG mask aligned to the video frame: white marks removal, black marks retention. It applies to the entire clip. |
promptOptional | string | — | — | Optional short description of the objects or area to remove and the surrounding context. |
Example request
This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.
The example uses PopNow sample files in mask_url, video_url. Replace them with your own public HTTPS links, uploads or saved assets.
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: $(uuidgen)" \
-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"
}
}'The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"