Vai al contenuto

Birefnet

Integra

ID del modello 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Fino a 2,07 $ per esecuzione addebitato in base all'utilizzo effettivo, il resto viene rimborsato Esegui in questa pagina

Ottieni la chiave API
BiRefNet Rimozione dello sfondo #utility#editing

Rimuove lo sfondo dai video, con sei modelli disponibili, modalità matting e output mp4, webm, mov o gif

BiRefNet · Video

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 video_url
Trascina un file oppure

URL che identifica il video il cui sfondo verrà rimosso.

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

video_output_type predefinito X264 (.mp4)

Tipo di output per il video risultante.

video_quality predefinito high

Livello di qualità del video risultante.

video_write_mode predefinito balanced

Modalità di scrittura del video 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/video?wait=20 preventivo → 2,07 $
# 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/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.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

Applica la segmentazione BiRefNet a ogni fotogramma di un video da `video_url`. I modelli includono Light, Light 2K, Heavy, Matting, Portrait e Dynamic, con risoluzioni operative fino a 2304x2304 (solo per il modello Dynamic). L'output può essere X264 mp4, VP9 webm, ProRes 4444 mov o GIF, con le impostazioni `video_quality` e `video_write_mode`. È possibile richiedere un video maschera separato.

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.
video_urlobbligatorio video
Tipourl · video
URL che identifica il video il cui sfondo verrà rimosso.
video_output_typefacoltativo
Tipoenum
PredefinitoX264 (.mp4)
X264 (.mp4)VP9 (.webm)PRORES4444 (.mov)GIF (.gif)
Tipo di output per il video risultante.
video_qualityfacoltativo
Tipoenum
Predefinitohigh
lowmediumhighmaximum
Livello di qualità del video risultante.
video_write_modefacoltativo
Tipoenum
Predefinitobalanced
fastbalancedsmall
Modalità di scrittura del video risultante.
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/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.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
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}Video dopo la rimozione dello sfondo.
mask_video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames} | nullMaschera applicata durante la rimozione dello sfondo.

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