> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# bria-image-remove-background

> API usage guide for bria-image-remove-background.

{/* source_model_id: bria-image-remove-background */}

{/* source_updated_at: 1782846529 */}

**Model ID**

```bash theme={null}
bria-image-remove-background
```

**Calling method:** sync

# Bria Remove Background API Documentation

The Remove Background route removes the background from an input image, returning the foreground subject isolated on a transparent background. It is powered by Bria's RMBG 2.0 model.

## 1. API Endpoint & Authentication

Base URL: [https://console.gmicloud.ai](https://console.gmicloud.ai)
Endpoint: POST /api/v1/ie/requestqueue/apikey/requests
Header:
Authorization: Bearer YOUR\_API\_KEY
Content-Type: application/json

## 2. Model Specifications

* Pricing: \$0.018 per image
* Model: RMBG 2.0
* Input Formats: JPEG, PNG (Base64 string or URL)
* Output: Image with the background removed (transparent background)

## 3. How It Works

### Background Removal

Provide a single source image and the model detects the primary foreground subject, segments it, and removes everything behind it. The result is returned with the background made transparent, suitable for compositing onto a new background.

## 4. Parameter Reference

| Parameter | Type  | Required | Description                                      |
| :-------- | :---- | :------- | :----------------------------------------------- |
| image     | image | Yes      | Input image (Base64 string or URL; JPEG or PNG). |

## 5. Example CURL Request

```bash theme={null}
curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bria-image-remove-background",
    "payload": {
      "image": "https://example.com/source_image.jpg"
    }
  }'
```

## 6. Checking Request Status

```bash theme={null}
Endpoint: GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
```

* queued: Request is waiting to be processed by GPU resources.
* processing: Image processing is currently in progress.
* success: Processing completed. URLs available in outcome.media\_urls.
* failed: Processing failed. Check logs for details.