Saltar al cuntegna

BiRefNet V2 Background Removal

Integrar

ID dal model 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"

Questa dumonda: ≈$0,002 2 credits API Lantschar sin questa pagina

Obtegna ina clav API
BiRefNet Allontanament dal fund #cutout#matting#open-weights

Allontanament dal fund e matting fin a 2304 px, cun output da masca opziunal.

BiRefNet · Maletg

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

•obligatori image_url
Trametta in datoteca u

URL che identifica il maletg, dal qual il fund vegn allontanà.

Avanzà operating_resolution · output_format · model · output_mask · refine_foreground · mask_only
operating_resolution standard 1024x1024

Resoluziun da lavur, cun '2304x2304' limitada al model 'General Use (Dynamic)'. Per maletgs d'input ad auta resoluziun, regulaziuns pli autas megliereschan l'exactezza da l'output.

output_format standard png

Format dal maletg resultà.

standard General Use (Light)

Selecziun dal model per l'allontanament dal fund: 'General Use (Light)' correspunda a BiRefNet, il model original dal repositori BiRefNet, e vegn recumandà per la gronda part dals diever. 'General Use (Light 2K)' correspunda a BiRefNet_lite-2K e utilisescha quest model original scolà sin maletgs 2K. 'General Use (Heavy)' correspunda a BiRefNet_lite e porscha dapli exactezza cun in'elavuraziun pli lenta. 'Matting' correspunda a BiRefNet-matting ed è scolà spezialmain per il matting da maletgs. 'Portrait' correspunda a BiRefNet-portrait ed è scolà spezialmain sin maletgs da purtrets. 'General Use (Dynamic)' correspunda a BiRefNet_dynamic e sustegna resoluziuns variablas da 256x256 fin 2304x2304.

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

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart BiRefNet V2 Background Removal

BiRefNet V2 separa il subject dal fund cun pliras variantas dal model (light, heavy, matting, portrait, dynamic) e resoluziuns da lavur fin a 2304x2304. Returna il subject isolà e, opziunalmain, la masca en PNG, WebP u GIF.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
modelopziunal
Tipenum
StandardGeneral Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
Selecziun dal model per l'allontanament dal fund: 'General Use (Light)' correspunda a BiRefNet, il model original dal repositori BiRefNet, e vegn recumandà per la gronda part dals diever. 'General Use (Light 2K)' correspunda a BiRefNet_lite-2K e utilisescha quest model original scolà sin maletgs 2K. 'General Use (Heavy)' correspunda a BiRefNet_lite e porscha dapli exactezza cun in'elavuraziun pli lenta. 'Matting' correspunda a BiRefNet-matting ed è scolà spezialmain per il matting da maletgs. 'Portrait' correspunda a BiRefNet-portrait ed è scolà spezialmain sin maletgs da purtrets. 'General Use (Dynamic)' correspunda a BiRefNet_dynamic e sustegna resoluziuns variablas da 256x256 fin 2304x2304.
operating_resolutionopziunal
Tipenum
Standard1024x1024
1024x10242048x20482304x2304
Resoluziun da lavur, cun '2304x2304' limitada al model 'General Use (Dynamic)'. Per maletgs d'input ad auta resoluziun, regulaziuns pli autas megliereschan l'exactezza da l'output.
output_maskopziunal
Tipboolean
Standardfalse
Controlla sche la mascrina per l'allontanament dal fund vegn includida en l'output.
refine_foregroundopziunal
Tipboolean
Standardtrue
Controlla la raffinaziun dal primer plan sin basa da la mascrina stimada.
image_urlobligatori image
Tipurl · image
URL che identifica il maletg, dal qual il fund vegn allontanà.
output_formatopziunal
Tipenum
Standardpng
webppnggif
Format dal maletg resultà.
mask_onlyopziunal
Tipboolean
Standardfalse
Interrutg da l'output mo da la mascrina: `True` ignora la raffinaziun dal primer plan e lascha il maletg intact, restituind mo sia mascrina da segmentaziun. Sche mo ina mascrina è necessaria, quai evitescha calculs supplementars e reducescha ils datas transferids.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

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"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
image
object {url, content_type, file_name, file_size, width, height}Maletg suenter l'allontanament dal fund, u la mascrina da segmentaziun sche `mask_only` è `True`.
mask_image
object {url, content_type, file_name, file_size, width, height} | nullMascrina applitgada durant l'allontanament dal fund.

Dapli models: Allontanament dal fund

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/birefnet/v2.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt