Skip to content

Birefnet

Integrate

Model id birefnet/v2/video
# 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/birefnet/v2/video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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"

Up to $2.07 per run charged by actual usage, the rest is refunded Run it on this page

Get API key
BiRefNet Background Removal #utility#editing

Removes backgrounds from video, with six model choices, matting, and mp4, webm, mov or gif output

BiRefNet · Video

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 video_url
Drop a file, or

URL identifying the video whose background will be removed.

Advanced operating_resolution · video_output_type · video_quality · video_write_mode · model · output_mask · refine_foreground
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.

video_output_type default X264 (.mp4)

Output type for the resulting video.

video_quality default high

Quality level for the resulting video.

video_write_mode default balanced

Write mode for the resulting video.

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/video?wait=20 quote → $2.07
# 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/birefnet/v2/video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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 Birefnet

Applies BiRefNet segmentation to each frame of a video from `video_url`. Models include Light, Light 2K, Heavy, Matting, Portrait and Dynamic, with operating resolutions up to 2304x2304 (only for the Dynamic model). Output can be X264 mp4, VP9 webm, ProRes 4444 mov or GIF, with `video_quality` and `video_write_mode` settings. A separate mask video can be requested.

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.
video_urlrequired video
Typeurl · video
URL identifying the video whose background will be removed.
video_output_typeoptional
Typeenum
DefaultX264 (.mp4)
X264 (.mp4)VP9 (.webm)PRORES4444 (.mov)GIF (.gif)
Output type for the resulting video.
video_qualityoptional
Typeenum
Defaulthigh
lowmediumhighmaximum
Quality level for the resulting video.
video_write_modeoptional
Typeenum
Defaultbalanced
fastbalancedsmall
Write mode for the resulting video.
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/video",
  "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": 2070,
    "usd": "2.07",
    "charged": 2070,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    },
    "mask_video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "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
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}Video after background removal.
mask_video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames} | nullMask applied during background removal.

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