Skip to main content
Model ID
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 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

ParameterTypeRequiredDescription
imageimageYesInput image (Base64 string or URL; JPEG or PNG).

5. Example CURL Request

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

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.