Op den Inhalt sprangen

BiRefNet V2 Background Removal

Integréieren

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

Dës Ufro: ≈0,002 $ 2 API-Kreditter Op dëser Säit ausféieren

API-Schlëssel kréien
BiRefNet Hannergrondentfernung #cutout#matting#open-weights

Hannergrondentfernung a Matting bis zu 2304 px, mat optionaler Maskenausgab.

BiRefNet · Bild

Äin éischt Resultat kënnt hei hin

Baut hei drënner eng Ufro a féiert se mat Ärem API-Schlëssel aus. Output gëtt an eis Späicherung kopéiert, fir ëmmer oder 7 Deeg gratis gespäichert.

Eng Ufro erstellen

D'Kontrolle ginn aus dem Modellschema generéiert. De Code an de Präis aktualiséiere sech, wann s du se ännerst.

•obligatoresch image_url
Fichier erofzéien, oder

URL, déi d'Bild identifizéiert, deem säin Hannergrond ewechgeholl gëtt.

Erweidert operating_resolution · output_format · model · output_mask · refine_foreground · mask_only
operating_resolution Standard 1024x1024

Aarbechtsopléisung; '2304x2304' ass op de Modell 'General Use (Dynamic)' beschränkt. Bei héichopléisenden Input-Biller verbessere méi héich Astellungen d'Output-Genauegkeet.

output_format Standard png

Format vum resultéierende Bild.

Standard General Use (Light)

Auswiel vum Hannergrondentfernungs-Modell: 'General Use (Light)' entsprécht BiRefNet, dem Originalmodell vum BiRefNet-Repository, a gëtt fir déi meescht Uwendungen recommandéiert. 'General Use (Light 2K)' entsprécht BiRefNet_lite-2K a benotzt dësen Originalmodell, trainéiert mat 2K-Biller. 'General Use (Heavy)' entsprécht BiRefNet_lite a bitt méi Genauegkeet bei méi lueser Veraarbechtung. 'Matting' entsprécht BiRefNet-matting a gouf speziell fir Image-Matting trainéiert. 'Portrait' entsprécht BiRefNet-portrait a gouf speziell mat Portraitbiller trainéiert. 'General Use (Dynamic)' entsprécht BiRefNet_dynamic a ënnerstëtzt variabel Opléisunge vun 256x256 bis 2304x2304.

POST /run/birefnet/v2?wait=20 Präis → 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"

Dës Ufro ausféieren

Äre Schlëssel bleift an dësem Browser: e gëtt nëmmen un d'Doitong API geschéckt an nëmme gespäichert (localStorage), wann s du „Erënneren“ aktivéiers. En API-Schlëssel kréien

Iwwer BiRefNet V2 Background Removal

BiRefNet V2 trennt de Sujet vum Hannergrond mat verschiddene Modellvarianten (light, heavy, matting, portrait, dynamic) an Operatiounsopléisunge bis 2304x2304. Et gëtt den Ausschnëtt an optional d'Mask a PNG, WebP oder GIF zréck.

Parameteren

Schéck entweder den kanoneschen Numm oder den natierlechen Numm, net béid. Kanonesch Nimm

NummTyp StandardErlaabt Beschreiwung
modeloptional
Typenum
StandardGeneral Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
Auswiel vum Hannergrondentfernungs-Modell: 'General Use (Light)' entsprécht BiRefNet, dem Originalmodell vum BiRefNet-Repository, a gëtt fir déi meescht Uwendungen recommandéiert. 'General Use (Light 2K)' entsprécht BiRefNet_lite-2K a benotzt dësen Originalmodell, trainéiert mat 2K-Biller. 'General Use (Heavy)' entsprécht BiRefNet_lite a bitt méi Genauegkeet bei méi lueser Veraarbechtung. 'Matting' entsprécht BiRefNet-matting a gouf speziell fir Image-Matting trainéiert. 'Portrait' entsprécht BiRefNet-portrait a gouf speziell mat Portraitbiller trainéiert. 'General Use (Dynamic)' entsprécht BiRefNet_dynamic a ënnerstëtzt variabel Opléisunge vun 256x256 bis 2304x2304.
operating_resolutionoptional
Typenum
Standard1024x1024
1024x10242048x20482304x2304
Aarbechtsopléisung; '2304x2304' ass op de Modell 'General Use (Dynamic)' beschränkt. Bei héichopléisenden Input-Biller verbessere méi héich Astellungen d'Output-Genauegkeet.
output_maskoptional
Typboolean
Standardfalse
Steiert, ob d'Mask fir d'Hannergrondentfernung am Output enthale ass.
refine_foregroundoptional
Typboolean
Standardtrue
Steiert d'Verfeinerung vum Virdergrond op Basis vun der geschätzter Mask.
image_urlobligatoresch image
Typurl · image
URL, déi d'Bild identifizéiert, deem säin Hannergrond ewechgeholl gëtt.
output_formatoptional
Typenum
Standardpng
webppnggif
Format vum resultéierende Bild.
mask_onlyoptional
Typboolean
Standardfalse
Schalter fir nëmmen d'Mask auszeginn: `True` iwwerspréngt d'Virdergrondverfeinerung, léisst d'Bild onverännert a gëtt nëmmen d'Segmentéierungsmask zréck. Wann nëmmen eng Mask gebraucht gëtt, spuert dat Berechnung an Transfertdaten.
obligatoresch Kanoneschen Numm, och akzeptéiert

Fichierparameter akzeptéieren eng ëffentlech https:// URL, eng data: URI bis zu 10 MB oder de file_url vun engem Upload. Fichieren

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"
  }
}
Är Fichieren, Är WielAll outputs[].url ass eng Kopie an eiser Späicherung: fir ëmmer gespäichert (bezuelbar pro GB-Mount) oder 7 Deeg gratis, jee no Ärer Kontastellung oder ?storage=.
D'selwecht Struktur bei all Modelltype, url, content_type, width, height an duration, fir Biller, Video an Audio gläichermoossen. output ass dem Modell säin eegent Resultatobjet.
Output-Felder
image
object {url, content_type, file_name, file_size, width, height}Bild nom Ewechhuele vum Hannergrond oder d'Segmentéierungsmask, wann `mask_only` `True` ass.
mask_image
object {url, content_type, file_name, file_size, width, height} | nullMask, déi beim Ewechhuele vum Hannergrond ugewannt gëtt.

Méi Modeller: Hannergrondentfernung

Fir AI-Agenten: dës Säit als Markdown ass ënner https://doitong.com/lb/developers/models/birefnet/v2.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt