Skip to content

BiRefNet V2 Background Removal

Integrate

Model id birefnet/v2
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/birefnet/v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
  }'

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

This request: ≈$0.002 2 API credits Run it on this page

Get API key
BiRefNet Background Removal #cutout#matting#open-weights

Open background removal and matting at up to 2304 px, with optional mask output.

BiRefNet · 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.

•required image_url
Drop a file, or

URL identifying the image whose background will be removed.

Advanced operating_resolution · output_format · model · output_mask · refine_foreground · mask_only
operating_resolution default 1024x1024

Working resolution, with '2304x2304' restricted to the 'General Use (Dynamic)' model. For high-resolution input images, higher settings improve output accuracy.

output_format default png

Format for the resulting image.

default General Use (Light)

Background-removal model selection: 'General Use (Light)' maps to BiRefNet, is the BiRefNet repository's original model, and is recommended for most uses. 'General Use (Light 2K)' maps to BiRefNet_lite-2K and uses that original model trained on 2K images. 'General Use (Heavy)' maps to BiRefNet_lite and provides greater accuracy with slower processing. 'Matting' maps to BiRefNet-matting and is trained specifically for image matting. 'Portrait' maps to BiRefNet-portrait and is trained specifically on portrait images. 'General Use (Dynamic)' maps to BiRefNet_dynamic and supports variable resolutions ranging from 256x256 to 2304x2304.

POST /run/birefnet/v2?wait=20 quote → $0.002
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/birefnet/v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/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 BiRefNet V2 Background Removal

BiRefNet V2 separates the subject from the background with several model variants (light, heavy, matting, portrait, dynamic) and operating resolutions up to 2304x2304. Returns the cut-out and optionally the mask in PNG, WebP or GIF.

Parameters

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

NameType DefaultAllowed Description
modeloptional
Typeenum
DefaultGeneral Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
Background-removal model selection: 'General Use (Light)' maps to BiRefNet, is the BiRefNet repository's original model, and is recommended for most uses. 'General Use (Light 2K)' maps to BiRefNet_lite-2K and uses that original model trained on 2K images. 'General Use (Heavy)' maps to BiRefNet_lite and provides greater accuracy with slower processing. 'Matting' maps to BiRefNet-matting and is trained specifically for image matting. 'Portrait' maps to BiRefNet-portrait and is trained specifically on portrait images. 'General Use (Dynamic)' maps to BiRefNet_dynamic and supports variable resolutions ranging from 256x256 to 2304x2304.
operating_resolutionoptional
Typeenum
Default1024x1024
1024x10242048x20482304x2304
Working resolution, with '2304x2304' restricted to the 'General Use (Dynamic)' model. For high-resolution input images, higher settings improve output accuracy.
output_maskoptional
Typeboolean
Defaultfalse
Controls whether the background-removal mask is included in the output.
refine_foregroundoptional
Typeboolean
Defaulttrue
Controls foreground refinement based on the estimated mask.
image_urlrequired image
Typeurl · image
URL identifying the image whose background will be removed.
output_formatoptional
Typeenum
Defaultpng
webppnggif
Format for the resulting image.
mask_onlyoptional
Typeboolean
Defaultfalse
Mask-only output switch: `True` bypasses foreground refinement and leaves the image untouched, returning just its segmentation mask. When a mask alone is needed, this avoids extra computation and reduces transferred data.
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": "birefnet/v2",
  "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": 2,
    "usd": "0.002",
    "charged": 2,
    "refunded": 0
  },
  "input": {
    "image": "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
  },
  "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
    },
    "mask_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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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}Image after background removal, or the segmentation mask when `mask_only` is `True`.
mask_image
object {url, content_type, file_name, file_size, width, height} | nullMask applied during background removal.

More models: Background Removal

For AI agents: this page as Markdown is at https://doitong.com/developers/models/birefnet/v2.md. All models and guides: https://doitong.com/developers/llms.txt