Vai al contenuto

BiRefNet V2 Background Removal

Integra

ID del modello 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 richiesta: ≈0,002 $ 2 crediti API Esegui in questa pagina

Ottieni la chiave API
BiRefNet Rimozione dello sfondo #cutout#matting#open-weights

Rimozione e scontorno dello sfondo fino a 2304 px, con output opzionale della maschera.

BiRefNet · Immagine

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio image_url
Trascina un file oppure

URL che identifica l'immagine il cui sfondo verrà rimosso.

Avanzate operating_resolution · output_format · model · output_mask · refine_foreground · mask_only
operating_resolution predefinito 1024x1024

Risoluzione di lavoro; '2304x2304' è limitata al modello 'General Use (Dynamic)'. Per le immagini input ad alta risoluzione, impostazioni maggiori migliorano l'accuratezza dell'output.

output_format predefinito png

Formato dell'immagine risultante.

predefinito General Use (Light)

Selezione del modello per la rimozione dello sfondo: 'General Use (Light)' corrisponde a BiRefNet, il modello originale del repository BiRefNet, ed è consigliato per la maggior parte degli usi. 'General Use (Light 2K)' corrisponde a BiRefNet_lite-2K e usa quel modello originale addestrato su immagini 2K. 'General Use (Heavy)' corrisponde a BiRefNet_lite e offre maggiore accuratezza con un'elaborazione più lenta. 'Matting' corrisponde a BiRefNet-matting ed è addestrato specificamente per il matting delle immagini. 'Portrait' corrisponde a BiRefNet-portrait ed è addestrato specificamente su immagini ritratto. 'General Use (Dynamic)' corrisponde a BiRefNet_dynamic e supporta risoluzioni variabili da 256x256 a 2304x2304.

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

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su BiRefNet V2 Background Removal

BiRefNet V2 separa il soggetto dallo sfondo con diverse varianti del modello (light, heavy, matting, portrait, dynamic) e risoluzioni operative fino a 2304x2304. Restituisce il ritaglio e, opzionalmente, la maschera in PNG, WebP o GIF.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
modelfacoltativo
Tipoenum
PredefinitoGeneral Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
Selezione del modello per la rimozione dello sfondo: 'General Use (Light)' corrisponde a BiRefNet, il modello originale del repository BiRefNet, ed è consigliato per la maggior parte degli usi. 'General Use (Light 2K)' corrisponde a BiRefNet_lite-2K e usa quel modello originale addestrato su immagini 2K. 'General Use (Heavy)' corrisponde a BiRefNet_lite e offre maggiore accuratezza con un'elaborazione più lenta. 'Matting' corrisponde a BiRefNet-matting ed è addestrato specificamente per il matting delle immagini. 'Portrait' corrisponde a BiRefNet-portrait ed è addestrato specificamente su immagini ritratto. 'General Use (Dynamic)' corrisponde a BiRefNet_dynamic e supporta risoluzioni variabili da 256x256 a 2304x2304.
operating_resolutionfacoltativo
Tipoenum
Predefinito1024x1024
1024x10242048x20482304x2304
Risoluzione di lavoro; '2304x2304' è limitata al modello 'General Use (Dynamic)'. Per le immagini input ad alta risoluzione, impostazioni maggiori migliorano l'accuratezza dell'output.
output_maskfacoltativo
Tipoboolean
Predefinitofalse
Controlla se la maschera di rimozione dello sfondo viene inclusa nell'output.
refine_foregroundfacoltativo
Tipoboolean
Predefinitotrue
Controlla il perfezionamento del primo piano in base alla maschera stimata.
image_urlobbligatorio image
Tipourl · image
URL che identifica l'immagine il cui sfondo verrà rimosso.
output_formatfacoltativo
Tipoenum
Predefinitopng
webppnggif
Formato dell'immagine risultante.
mask_onlyfacoltativo
Tipoboolean
Predefinitofalse
Interruttore per l'output della sola maschera: `True` bypassa il perfezionamento del primo piano e lascia invariata l'immagine, restituendo solo la maschera di segmentazione. Quando serve solo una maschera, evita calcoli aggiuntivi e riduce i dati trasferiti.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
image
object {url, content_type, file_name, file_size, width, height}Immagine dopo la rimozione dello sfondo, oppure maschera di segmentazione quando `mask_only` è `True`.
mask_image
object {url, content_type, file_name, file_size, width, height} | nullMaschera applicata durante la rimozione dello sfondo.

Altri modelli: Rimozione dello sfondo

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/birefnet/v2.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt