---
title: "Eraser"
method: POST
path: "/erase"
tags: ["Editing Endpoints"]
---

# Eraser

`POST /erase`

[**Try out this capability in Bria's sandbox**](https://platform.bria.ai/video-editing/eraser-video)


**Description**
Initiates an asynchronous object erasure job. Removes objects defined by the mask input and reconstructs the background.


**Mask Input**


This endpoint requires a mask definition object. You can provide a direct `mask_url`, or use one of our masking endpoints (`mask_by_prompt`, `mask_by_key_points`) to define the mask area.


Response behavior:

- Returns HTTP 202 with `request_id` and `status_url`

- Check job status by polling `status_url` or by calling the [Status Service](https://docs.bria.ai/status) with the `request_id` until a terminal status is returned


Constraints & Limits:

- **Max Duration:** 5 seconds. Videos longer than 5s will be truncated if `auto_trim` is true, or rejected if false.

- **Max Resolution:** 750p. Inputs higher than 750p will be automatically downscaled.

- **Frame Rate:** Recommended 24 FPS (preserved in output).


Preservation Rules:

- Aspect Ratio (within 16:9 constraint)

- Frame Rate

- Audio (preserved by default)

## Headers

- `api_token` string, required

## Request body

- object
  - `video` string, required — Publicly accessible URL of the input video.
  - `mask` string, required — Required. A URL with mask video defining the area to erase.
  - `preserve_audio` boolean — Whether to keep the original audio track.
  - `auto_trim` boolean — If true, videos longer than 5 seconds are trimmed to the first 5 seconds.
  - `output_container_and_codec` 'mp4_h264' | 'mp4_h265' | 'webm_vp9' | 'mov_h265' | 'mov_proresks' | 'mkv_h264' | 'mkv_h265' | 'mkv_vp9' | 'gif' — Output container and codec preset.
  - `webhook_url` string, uri — Optional URL for receiving the result via webhook when the async job completes. See [Webhooks](https://docs.bria.ai/webhooks).

## Response `202`

Accepted

- AsyncInitialResponse
  - `request_id` string, required
  - `status_url` string, required

## Other responses

- `400` — Bad request
- `403` — Forbidden
- `405` — Method not allowed
- `415` — Unsupported input container or codec
- `422` — Unprocessable entity
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.net/bria-ai/apis/video-api-reference.md) · [All operations](https://skmtc.net/bria-ai/apis/video-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bria-ai/video-api-reference/revisions/fa6d2efc9689/schema)