# Overview

Bria's Video Editing APIs empowers builders with powerful tools for programmatically transforming video content while maintaining original quality.


**Asynchronous Requests and the Status Service**  

Bria API v2 endpoints process requests asynchronously by default. When you make an asynchronous request, the API immediately returns a `request_id` and a `status_url` instead of the final result. Use the Status Service to track the request's progress until it reaches a completed state.  

See the full guide at [Status Service Documentation](https://docs.bria.ai/status) for complete details and usage examples.



## Servers

```
https://engine.prod.bria-api.com/v2/video/edit
```

## Download OpenAPI description

[Overview](https://docs.bria.ai/_spec/video-editing.yaml)

## Endpoints

### Increase Resolution - up to 8K

 - [POST /increase_resolution](https://docs.bria.ai/video-editing/endpoints/increase-resolution.md): Initiates an asynchronous resolution upscaling job for a video.


Response behavior:
- Returns HTTP 202 with  and 
- Check job status by polling  or by calling the Status Service with the  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: 30 seconds
- Max output resolution: 7680x4320 (8K). If the selected  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/endpoints/remove-background.md): Initiates an asynchronous background removal job for a video.

Response behavior:
- Returns HTTP 202 with  and 
- Check job status by polling  or by calling the Status Service with the  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: 30 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:
-  must be one of the predefined string values listed below. Hex values are not supported. Default is .
- If  is , the selected output preset must support alpha. Otherwise the server responds with 422 Unprocessable Entity.

Output transparency support by preset:
- Alpha supported: , , , , ,  when encoded as HEVC with Alpha
- Alpha not supported: , , , ,