# Editing Endpoints

Tools for modifying video content (Erase, Upscale, Remove BG)

## Eraser

 - [POST /erase](https://docs.bria.ai/video-editing/editing-endpoints/erase-object.md): Try out this capability in Bria's sandbox


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 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)

## Increase Resolution - up to 8K

 - [POST /increase_resolution](https://docs.bria.ai/video-editing/editing-endpoints/increase-resolution.md): Try out this capability in Bria's sandbox


Description
Initiates an asynchronous resolution upscaling job for a video.

Upscales up to 8K output!


Response behavior:

- Returns HTTP 202 with request_id and status_url

- Check job status by polling status_url or by calling the Status Service with the request_id until a terminal status is returned


Supported input containers:

- .mp4, .mov, .webm, .avi, .gif


Supported input codecs:

- H.264, H.265 (HEVC), VP9, AV1, PhotoJPEG


Input attributes preserved in output:

- Aspect Ratio

- Frame Rate

- Color Bit Depth

- Audio if present

- Transparency if present and supported by the selected output preset


Limits:

- Max input duration: 60 seconds

- Max output resolution: 7680x4320 (8K). If the selected desired_increase would exceed this limit the server returns 422 Unprocessable Entity.


Encoding:

- Bitrate is adjusted automatically to match the target resolution to preserve quality.

## Remove Background

 - [POST /remove_background](https://docs.bria.ai/video-editing/editing-endpoints/remove-background.md): Try out this capability in Bria's sandbox


Description
Initiates an asynchronous background removal job for a video.


Response behavior:

- Returns HTTP 202 with request_id and status_url

- Check job status by polling status_url or by calling the Status Service with the request_id until a terminal status is returned


Supported input containers:

- .mp4, .mov, .webm, .avi, .gif


Supported input codecs:

- H.264, H.265 (HEVC), VP9, AV1, PhotoJPEG


Input attributes preserved in output:

- Aspect Ratio and resolution

- Frame Rate

- Audio if present


Limits:

- Max input duration: 60 seconds

- Resolutions: Input resolution up to 16000x16000 (16K). Inputs larger than this return 413 Payload Too Large. Output resolution matches the input resolution.


Background and transparency control:

- background_color must be one of the predefined string values listed below. Hex values are not supported. Default is Transparent.

- If background_color is Transparent, the selected output preset must support alpha. Otherwise the server responds with 422 Unprocessable Entity.


Output transparency support by preset:

- Alpha supported: webm_vp9, mov_proresks, mkv_vp9, mkv_raw, gif, mov_h265 when encoded as HEVC with Alpha

- Alpha not supported: mp4_h264, mp4_h265, mkv_h264, mkv_h265, avi_h264