Eraser
Changed onTry 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 endpoint 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)
Request
- Base URL: https://engine.prod.bria-api.com/v2/video/edit
- URL: https://engine.prod.bria-api.com/v2/video/edit/erase
- Auth: API key in header api_token
Request body
Response
Accepted
Changes
- warning
deleted the
headerrequest parameterapi_token - info
api tag
Editingadded - info
api tag
Editing Endpointsremoved
- warning