bria/generate-background
Bria Background Generation allows for efficient swapping of backgrounds in images via text prompts or reference image, delivering realistic and polished results. Trained exclusively on licensed data for safe and risk-free commercial use
Capabilities
Cost
Community model (estimated from hardware time)
Input Parameters
| Name | Type | Description | Default | Constraints |
|---|---|---|---|---|
bg_prompt | string | Text description of the new scene or background. Either bg_prompt or ref_image_url must be provided | — | — |
content_moderation | boolean | Enable content moderation | false | — |
enhance_ref_image | boolean | [DEPRECATED] Enhance reference image. No longer used in V2 API. | true | — |
fast | boolean | [DEPRECATED] Use fast mode. No longer used in V2 API. | true | — |
force_rmbg | boolean | [DEPRECATED] Force background removal. No longer used in V2 API. | false | — |
image | string (uri) | Image file | — | — |
image_url | string | Image URL | — | — |
negative_prompt | string | Negative prompt for image generation | — | — |
original_quality | boolean | Retain original input image size, otherwise scale to 1MP | false | — |
ref_image_file | string (uri) | Reference image file for background generation | — | — |
ref_image_url | string | URL of reference image for background generation. Either bg_prompt or ref_image_url must be provided | — | — |
refine_prompt | boolean | Refine the prompt for optimal results | true | — |
seed | integer | Random seed. Set for reproducible generation | — | — |
sync | boolean | Synchronous response mode | true | — |
bg_prompt string Text description of the new scene or background. Either bg_prompt or ref_image_url must be provided
content_moderation boolean Enable content moderation
false enhance_ref_image boolean [DEPRECATED] Enhance reference image. No longer used in V2 API.
true fast boolean [DEPRECATED] Use fast mode. No longer used in V2 API.
true force_rmbg boolean [DEPRECATED] Force background removal. No longer used in V2 API.
false image string Image file
image_url string Image URL
negative_prompt string Negative prompt for image generation
original_quality boolean Retain original input image size, otherwise scale to 1MP
false ref_image_file string Reference image file for background generation
ref_image_url string URL of reference image for background generation. Either bg_prompt or ref_image_url must be provided
refine_prompt boolean Refine the prompt for optimal results
true seed integer Random seed. Set for reproducible generation
sync boolean Synchronous response mode
true 2555256f9a28 Updated: 2/26/2026 50.5K runs
cinemasetfree.com