Skip to content

Bria Guided Remove Background

Integrate

Model id bria/guided-remove-background
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/bria/guided-remove-background?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: $0.03 30 API credits · ≈ ₽3.20 Run it on this page

Get API key
Bria AI · Image

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

Optional plain-language adjustment to the default cutout: expand the selection with 'the person with the mat and the plant', exclude objects with 'the woman at her desk without the lamp', or restrict it with 'only the chair'. An empty value selects the photo's obvious subject without adjustment. Retained pixels remain unchanged; only a new alpha channel is added.

Advanced image · autocrop
image_url default https://labs-assets.b...
Drop a file, or

Source image supplied through a public URL, raw base64-encoded image bytes, or a base64 data URI such as data:image/png;base64,... .

POST /run/bria/guided-remove-background?wait=20 quote → $0.03
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/bria/guided-remove-background?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Bria Guided Remove Background

Starts from a default cutout of the main subject in `image_url`, then adjusts it using an optional plain-language `prompt`, for example keeping an extra object or isolating just one. Original pixels are kept and an alpha channel is added, returned as RGBA PNG. `autocrop` tightens the canvas to the kept content.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
image_urloptional image
Typeurl · image
Defaulthttps://labs-assets.bria.ai/api-examples/guided-remove-background/yoga_studio_input.jpg
Source image supplied through a public URL, raw base64-encoded image bytes, or a base64 data URI such as data:image/png;base64,... .
promptoptional
Typestring | null
Optional plain-language adjustment to the default cutout: expand the selection with 'the person with the mat and the plant', exclude objects with 'the woman at her desk without the lamp', or restrict it with 'only the chair'. An empty value selects the photo's obvious subject without adjustment. Retained pixels remain unchanged; only a new alpha channel is added.
autocropoptional
Typeboolean
Defaultfalse
Crop the output canvas tightly around retained content.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/guided-remove-background",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 30,
    "usd": "0.03",
    "charged": 30,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    }
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
image
object {url, content_type, file_name, file_size, width, height}RGBA PNG retaining the source photo with a newly created alpha channel that selects the apparent main subject, refined according to the prompt.

More models: Background Removal

For AI agents: this page as Markdown is at https://doitong.com/en-US/developers/models/bria/guided-remove-background.md. All models and guides: https://doitong.com/developers/llms.txt