Siirry sisältöön

BiRefNet V2 Background Removal

Integroi

Mallin tunniste 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"

Tämä pyyntö: ≈0,002 $ 2 API-krediittiä Suorita tällä sivulla

Hanki API-avain
BiRefNet Taustan poisto #cutout#matting#open-weights

Avoimen taustan poisto ja irrotus enintään 2304 px:n tarkkuudella, valinnainen maskituloste.

BiRefNet · Kuva

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

•pakollinen image_url
Pudota tiedosto tai

URL, joka yksilöi kuvan, jonka tausta poistetaan.

Lisäasetukset operating_resolution · output_format · model · output_mask · refine_foreground · mask_only
operating_resolution oletus 1024x1024

Työskentelyresoluutio; '2304x2304' on sallittu vain 'General Use (Dynamic)'-mallilla. Suuren resoluution syötekuvissa suuremmat asetukset parantavat tulosteen tarkkuutta.

output_format oletus png

Tuloksena syntyvän kuvan muoto.

oletus General Use (Light)

Taustanpoistomallin valinta: 'General Use (Light)' vastaa BiRefNet-mallia, on BiRefNet-repositorion alkuperäinen malli ja suositeltu useimpiin käyttötarkoituksiin. 'General Use (Light 2K)' vastaa BiRefNet_lite-2K-mallia, joka on koulutettu 2K-kuvilla. 'General Use (Heavy)' vastaa BiRefNet_lite-mallia ja tarjoaa paremman tarkkuuden hitaammalla käsittelyllä. 'Matting' vastaa BiRefNet-matting-mallia ja on koulutettu erityisesti kuvamatotukseen. 'Portrait' vastaa BiRefNet-portrait-mallia ja on koulutettu erityisesti muotokuviin. 'General Use (Dynamic)' vastaa BiRefNet_dynamic-mallia ja tukee vaihtelevia resoluutioita välillä 256x256–2304x2304.

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

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: BiRefNet V2 Background Removal

BiRefNet V2 erottaa kohteen taustasta useilla mallivarianteilla (light, heavy, matting,\nportrait, dynamic) ja enintään 2304x2304:n käsittelytarkkuudella. Se palauttaa irrotetun kohteen ja haluttaessa maskin\nPNG-, WebP- tai GIF-muodossa.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
modelvalinnainen
Tyyppienum
OletusGeneral Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
Taustanpoistomallin valinta: 'General Use (Light)' vastaa BiRefNet-mallia, on BiRefNet-repositorion alkuperäinen malli ja suositeltu useimpiin käyttötarkoituksiin. 'General Use (Light 2K)' vastaa BiRefNet_lite-2K-mallia, joka on koulutettu 2K-kuvilla. 'General Use (Heavy)' vastaa BiRefNet_lite-mallia ja tarjoaa paremman tarkkuuden hitaammalla käsittelyllä. 'Matting' vastaa BiRefNet-matting-mallia ja on koulutettu erityisesti kuvamatotukseen. 'Portrait' vastaa BiRefNet-portrait-mallia ja on koulutettu erityisesti muotokuviin. 'General Use (Dynamic)' vastaa BiRefNet_dynamic-mallia ja tukee vaihtelevia resoluutioita välillä 256x256–2304x2304.
operating_resolutionvalinnainen
Tyyppienum
Oletus1024x1024
1024x10242048x20482304x2304
Työskentelyresoluutio; '2304x2304' on sallittu vain 'General Use (Dynamic)'-mallilla. Suuren resoluution syötekuvissa suuremmat asetukset parantavat tulosteen tarkkuutta.
output_maskvalinnainen
Tyyppiboolean
Oletusfalse
Määrittää, sisällytetäänkö taustanpoistomaski tulosteeseen.
refine_foregroundvalinnainen
Tyyppiboolean
Oletustrue
Määrittää etualan hienosäädön arvioidun maskin perusteella.
image_urlpakollinen image
Tyyppiurl · image
URL, joka yksilöi kuvan, jonka tausta poistetaan.
output_formatvalinnainen
Tyyppienum
Oletuspng
webppnggif
Tuloksena syntyvän kuvan muoto.
mask_onlyvalinnainen
Tyyppiboolean
Oletusfalse
Vain maski -tulosteen kytkin: `True` ohittaa etualan hienosäädön ja jättää kuvan muuttamatta palauttaen vain sen segmentointimaskin. Kun tarvitaan pelkkä maski, tämä vähentää laskentaa ja siirrettävän datan määrää.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
image
object {url, content_type, file_name, file_size, width, height}Taustanpoiston jälkeinen kuva tai segmentointimaski, kun `mask_only` on `True`.
mask_image
object {url, content_type, file_name, file_size, width, height} | nullTaustanpoiston aikana käytetty maski.

Lisää malleja: Taustan poisto

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/birefnet/v2.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt