Bria Background API

• Remove
• Replace

Endpoint: POST https://fal.run/fal-ai/bria/background/remove Endpoint ID: fal-ai/bria/background/remove

Try it in the Playground

Run this model interactively with your own prompts.

​

Quick Start

Python

JavaScript

cURL

import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "fal-ai/bria/background/remove",
    arguments={
        "image_url": "https://fal.media/files/panda/K5Rndvzmn1j-OI1VZXDVd.jpeg"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

​

Examples

​

Input Schema

​

image_url

string

required

Input Image to erase from

​

sync_mode

boolean

default:"false"

If True, the media will be returned as a data URI and the output data won’t be available in the request history.

​

Output Schema

​

image

Image

required

The generated image

​

Input Example

{
  "image_url": "https://fal.media/files/panda/K5Rndvzmn1j-OI1VZXDVd.jpeg",
  "sync_mode": false
}

​

Output Example

{
  "image": {
    "content_type": "image/png",
    "file_name": "070c731993e949d993c10ef6283d335d.png",
    "file_size": 1076276,
    "height": 1024,
    "url": "https://v3.fal.media/files/tiger/GQEMNjRyxSoza7N8LPPqb_070c731993e949d993c10ef6283d335d.png",
    "width": 1024
  }
}

Endpoint: POST https://fal.run/fal-ai/bria/background/replace Endpoint ID: fal-ai/bria/background/replace

Try it in the Playground

Run this model interactively with your own prompts.

​

Quick Start

Python

JavaScript

cURL

import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "fal-ai/bria/background/replace",
    arguments={
        "image_url": "https://storage.googleapis.com/falserverless/bria/bria_bg_replace_fg.jpg"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

​

Input Schema

​

image_url

string

required

Input Image to erase from

​

ref_image_url

string

default:""

The URL of the reference image to be used for generating the new background. Use "" to leave empty. Either ref_image_url or bg_prompt has to be provided but not both. If both ref_image_url and ref_image_file are provided, ref_image_url will be used. Accepted formats are jpeg, jpg, png, webp. Default value: ""

​

prompt

string

The prompt you would like to use to generate images.

​

negative_prompt

string

default:""

The negative prompt you would like to use to generate images. Default value: ""

​

refine_prompt

boolean

default:"true"

Whether to refine prompt Default value: true

​

seed

integer

The same seed and the same prompt given to the same version of the model will output the same image every time.Range: 0 to 2147483647

​

fast

boolean

default:"true"

Whether to use the fast model Default value: true

​

num_images

integer

default:"1"

Number of Images to generate. Default value: 1Range: 1 to 4

​

sync_mode

boolean

default:"false"

If True, the media will be returned as a data URI and the output data won’t be available in the request history.

​

Output Schema

​

images

list<Image>

required

The generated images

​

seed

integer

required

Seed value used for generation.

​

Input Example

{
  "image_url": "https://storage.googleapis.com/falserverless/bria/bria_bg_replace_fg.jpg",
  "ref_image_url": "https://storage.googleapis.com/falserverless/bria/bria_bg_replace_bg.jpg",
  "prompt": "Man leaning against a wall",
  "negative_prompt": "",
  "refine_prompt": true,
  "fast": true,
  "num_images": 1,
  "sync_mode": false
}

​

Output Example

{
  "images": [
    {
      "content_type": "image/png",
      "url": "https://storage.googleapis.com/falserverless/bria/bria_bg_replace_res.jpg"
    }
  ]
}

​

Performance

​

Built for Commercial Deployment

• Enterprise-safe training data: Every training image carries commercial licensing, eliminating copyright exposure in regulated industries
• Transparent background removal: Clean PNG output with alpha channel preservation for immediate compositing workflows
• Single-purpose optimization: Focused solely on background segmentation rather than multi-task compromise
• Straightforward integration: Standard image URL input via fal’s API with synchronous or asynchronous processing modes

​

Technical Specifications

​

How It Stacks Up

​

Related

• Bria Expand Image — Image Generation
• Bria Eraser — Image Generation
• Bria Product Shot — Image Generation
• Bria Background Replace — Image Generation
• Video — Video Generation
• Bria GenFill — Image Generation
• Replace Background — Image Generation
• Bria Text-to-Image HD — Image Generation
• Bria Text-to-Image Base — Image Generation
• Embed Product — Image Generation
• Bria Text-to-Image Fast — Image Generation
• Bria RMBG 2.0 — Image Generation

​

Limitations

• seed range: 0 to 2147483647
• num_images range: 1 to 4