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