Eraser

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)