Overview

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude

Description

The Eraser Route enables the removal of elements or specific areas from a given image.

You can define the area to be removed by providing a mask that outlines the region to be erased. There are two main ways recommended to generate these masks:

1. Masks can be created by allowing users to draw directly on the image with a brush, for example. To access the SDK that demonstrates how to implement a brush feature in your interface, please refer to the following link.

2. By using the /objects/mask_generator route, which will generate all the possible masks for an image.

Output Characteristics

• The modified image is returned at the original resolution, preserving full visual quality without any automatic resizing or downscaling.
• All areas outside the provided mask remain completely unchanged, ensuring pixel-perfect preservation of unedited regions.

Description

The GenFill Route enables the generation of objects by prompt in a specific region of an image.

You can define the area for object generation by using a mask that outlines the region where the object will be created. Our model is optimized to work seamlessly with blob-shaped masks.

Masks can be created by allowing users to draw directly on the image with a brush, for example. To access the SDK that demonstrates how to implement a brush feature in your interface, please refer to the following link.

Output Characteristics

• The modified image is returned at the original resolution, preserving full visual quality without any automatic resizing or downscaling.
• All areas outside the provided mask remain completely unchanged, ensuring pixel-perfect preservation of unedited regions.
• If the input includes an alpha channel and preserve_alpha=true, the original transparency values (both full and partial) are maintained in the output.

Content Moderation

This endpoint includes granular content moderation controls to ensure safe usage across all stages of processing:

• Prompt Moderation – Validates the provided prompt and rejects requests containing unsafe or prohibited terms before processing starts.
• Input Image Moderation – Scans the uploaded image and stops processing if inappropriate or restricted content is detected.
• Output Image Moderation – Evaluates the generated image and blocks the response if it violates safety guidelines.

Description

The Remove BG Route can be used to remove the background of an image. This route leverages Bria's newest model, RMBG 2.0. For more details and to explore the model, check out the Hugging Face demo.

Content Moderation

This endpoint includes granular content moderation controls to ensure safe usage across all stages of processing:

• Input Image Moderation – Scans the uploaded image and stops processing if inappropriate or restricted content is detected.
• Output Image Moderation – Evaluates the generated image and blocks the response if it violates safety guidelines.

Constraints

The Bria API currently supports only JPEG and PNG files in RGB, RGBA, or CMYK color modes. When the file is of a different type or color mode, the status code 415 will be returned.

Transparency and Customizable Binarization

This endpoint returns an image where the background is removed, and the foreground remains with varying levels of transparency, allowing for smoother edges and more natural blending when placed over different backgrounds. Additionally, this unique output provides developers with the flexibility to binarize the result—transforming it into a binary mask—by setting a custom transparency threshold according to their specific use case. A binary mask is an image where pixels are either fully visible (foreground) or fully transparent (background), commonly used in visual generative AI and image processing pipelines. This capability enables seamless integration into workflows that require clear separation between subject and background, while still offering control over how strict this separation should be.

Below is a simple Python script to demonstrate how you can binarize the output image from the API. This allows you to set your own threshold to determine which areas are considered "foreground" and which are "background."

from PIL import Image
import numpy as np

# Load the image (the output from the API)
image = Image.open('output_image.png').convert('RGBA')

# Convert to numpy array
data = np.array(image)

# Define your threshold (0-255, where 255 is fully opaque)
threshold = 128

# Apply the threshold: if alpha > threshold, set to fully opaque (255), otherwise transparent (0)
data[:, :, 3] = np.where(data[:, :, 3] > threshold, 255, 0)

# Create a new Image from the modified array
binarized_image = Image.fromarray(data)

# Save or display
binarized_image.save('binarized_output.png')
binarized_image.show()

Description

The Replace BG Route is used to replace the background of any image.

We offer a fast version of this feature, powered by Bria 2.3 Fast LoRA (model card on Hugging Face), which provides an optimal balance between speed and quality.

This endpoint also allows replacing the background with a solid color of your choice. You can specify a hex color code (e.g., #FF5733) in the prompt to control the background color.

Here are some examples:

original image:

prompt: in a parking lot

result:

Content Moderation

This endpoint includes granular content moderation controls to ensure safe usage across all stages of processing:

• Prompt Moderation – Validates the provided prompt and rejects requests containing unsafe or prohibited terms before processing starts.
• Input Image Moderation – Scans the uploaded image and stops processing if inappropriate or restricted content is detected.
• Output Image Moderation – Evaluates the generated image and blocks the response if it violates safety guidelines.

Description

The Erase Foreground endpoint removes the primary subject (foreground) from the input image and intelligently generates the background to fill the erased area.

Output Characteristics

• Returns the edited image at its original resolution, ensuring full visual fidelity without any automatic resizing or downscaling.
• Only the foreground is removed; all other areas remain unaltered, preserving pixel-perfect accuracy in untouched regions.
• When preserve_alpha=true and the input image includes an alpha channel, the output maintains original transparency values (both full and partial).

Content Moderation

This endpoint includes granular content moderation controls to ensure safe usage across all stages of processing:

• Input Image Moderation – Scans the uploaded image and stops processing if inappropriate or restricted content is detected.
• Output Image Moderation – Evaluates the generated image and blocks the response if it violates safety guidelines.

Description

The background/blur Route is used to create a blur effect on the background of an image.

Content Moderation

This endpoint includes granular content moderation controls to ensure safe usage across all stages of processing:

• Input Image Moderation – Scans the uploaded image and stops processing if inappropriate or restricted content is detected.
• Output Image Moderation – Evaluates the generated image and blocks the response if it violates safety guidelines.

Description

The Image Expension Route can be used to expand an image, by utilizing generative AI.

You can decide on the image size of the final result as well as the position and size of the original image compared to the final result.

Alternatively, you can define a desired aspect_ratio, and the service will automatically place the input image in the center and expand the canvas to match that ratio.

In this way, you can create unique variations of your original image instead of cropping it into different aspect ratios and losing important details.

If aspect_ratio is not provided, both original_image_size and original_image_location must be specified.

Optimal input range

Input Image Area: Ensure that the ratio of the input image foreground or main subject to the canvas area is greater than 15% to achieve optimal results.

Canvas Size: The canvas size should be up to an area of 5000x5000 pixels.

Prompt: This parameter is optional. If not provided or left empty, the service will automatically generate a prompt based on the input image.

Alpha Channel Handling

• If the input image includes an alpha channel and preserve_alpha=true, newly generated pixels inherit the alpha values of the nearest original pixels along the same row or column, ensuring smooth transparency transitions.

• If the input image contains fully transparent pixels along any edge (top, bottom, left, or right), the request is rejected with a 422 error. Expansion is not supported in such cases to avoid undefined transparency behavior.

Here are some examples:

original image (Generated by Bria):

results:

original image (Stock Image):

results:

Content Moderation

This endpoint includes granular content moderation controls to ensure safe usage across all stages of processing:

• Prompt Moderation – Validates the provided prompt and rejects requests containing unsafe or prohibited terms before processing starts.
• Input Image Moderation – Scans the uploaded image and stops processing if inappropriate or restricted content is detected.
• Output Image Moderation – Evaluates the generated image and blocks the response if it violates safety guidelines.

Description

The /enhance_image endpoint improves the visual quality of an input image by generating richer details, sharper textures, and enhanced clarity. It also supports upscaling to higher resolutions and returns a refined version of the original visual.

Content Moderation

This endpoint includes granular content moderation controls to ensure safe usage across all stages of processing:

• Input Image Moderation – Scans the uploaded image and stops processing if inappropriate or restricted content is detected.
• Output Image Moderation – Evaluates the generated image and blocks the response if it violates safety guidelines.

Unlike the Increase Resolution route, this endpoint regenerates the image to enhance visual richness while preserving essential details.

Description

The Increase Resolution Route is used to upscale the resolution of any image.

Content Moderation

This endpoint includes granular content moderation controls to ensure safe usage across all stages of processing:

• Input Image Moderation – Scans the uploaded image and stops processing if inappropriate or restricted content is detected.
• Output Image Moderation – Evaluates the generated image and blocks the response if it violates safety guidelines.

Constraints

The Bria API currently supports only JPEG and PNG files in RGB, RGBA, or CMYK color modes. When the file is of a different type or color mode, the status code 415 will be returned.

It's possible to increase the resolution of an image up to a total area of 8192x8192 pixels.

Unlike the Enhance Image route, this endpoint does not add new details — it increases resolution using a dedicated upscaling method that preserves the original image content without regeneration.

Description

The Crop Route is used to remove the background from an image and crop tightly around the foreground or remaining region of interest. It supports both images with and without a background.

Content Moderation

This endpoint includes granular content moderation controls to ensure safe usage across all stages of processing:

• Input Image Moderation – Scans the uploaded image and stops processing if inappropriate or restricted content is detected.
• Output Image Moderation – Evaluates the generated image and blocks the response if it violates safety guidelines.