WaveSpeedAI APIBriaBria Eraser

Bria Eraser

Bria Eraser

Playground

Try it on WavespeedAI!

SOTA Object removal enables the precise removal of unwanted objects from images while maintaining high-quality outputs. Trained exclusively on licensed data for safe and risk-free commercial use

Features

Bria Eraser

Bria Eraser removes selected regions from an image using a mask, then inpaints the missing areas with context-aware detail that matches lighting, perspective, and texture. Trained on licensed data for compliant commercial use across ads, product shots, portraits, and scene cleanup.


✨ Highlights

  • Precise control with masks — erase exactly what you mark; keep everything else untouched.
  • Context-aware fill — realistic inpainting that blends edges, light, and color.
  • Alpha-friendly pipeline — preserve transparency for instant compositing.
  • Flexible delivery — sync or async API, URL or BASE64 outputs.

🧩 Parameters (1:1 with the panel)

  • image* (required) Source image (URL or upload).

  • mask_image* (required) black = keep, white = move


🚀 How to Use

  1. Upload/Paste image (required).
  2. Upload/Paste mask_image (required). White regions will be removed and inpainted.
  3. (Optional) Toggle preserve_alpha if you need transparent output for compositing.
  4. Click Run to generate and download your cleaned image.

💰 Pricing

  • Per run: $0.04

🧠 Practical Tips

  • Mask quality matters: use soft brushes at edges (5–15 px feather) to avoid seams.
  • Iterate fast: keep settings, adjust only the mask for rapid alternatives.
  • Compositing: with preserve_alpha, drop directly over new backgrounds or graded plates.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/bria/eraser" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "preserve_alpha": true,
    "enable_sync_mode": false,
    "enable_base64_output": false
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
imagestringYes-The URL of the image to erase.
mask_imagestringYes-The URL of the mask image to generate an image from.
preserve_alphabooleanNotrue-Preserve alpha channel in output
enable_sync_modebooleanNofalse-If set to true, the function will wait for the result to be generated and uploaded before returning the response. It allows you to get the result directly in the response. This property is only available through the API.
enable_base64_outputbooleanNofalse-If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

© 2025 WaveSpeedAI. All rights reserved.