Siirry sisältöön

Birefnet

Integroi

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

Enintään 2,07 $ suoritusta kohden veloitetaan todellisen käytön mukaan, loppu hyvitetään Suorita tällä sivulla

Hanki API-avain
BiRefNet Taustan poisto #utility#editing

Poistaa taustan videosta kuudella mallivaihtoehdolla, matting-tuella sekä mp4-, webm-, mov- tai gif-tulosteella

BiRefNet · Video

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 video_url
Pudota tiedosto tai

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

Lisäasetukset operating_resolution · video_output_type · video_quality · video_write_mode · model · output_mask · refine_foreground
operating_resolution oletus 1024x1024

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

video_output_type oletus X264 (.mp4)

Tuloksena syntyvän videon tulostetyyppi.

video_quality oletus high

Tuloksena syntyvän videon laatutaso.

video_write_mode oletus balanced

Tuloksena syntyvän videon kirjoitustila.

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/video?wait=20 hinta → 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"

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

Käyttää BiRefNet-segmentointia `video_url`-osoitteessa olevan videon jokaiseen kuvaan. Malleja ovat Light, Light 2K, Heavy, Matting, Portrait ja Dynamic, joiden käsittelyresoluutio on enintään 2304x2304 (vain Dynamic-mallilla). Tuloste voi olla X264 mp4, VP9 webm, ProRes 4444 mov tai GIF, ja sitä säädetään asetuksilla `video_quality` ja `video_write_mode`. Erillisen maskivideon voi pyytää.

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.
video_urlpakollinen video
Tyyppiurl · video
URL, joka yksilöi videon, jonka tausta poistetaan.
video_output_typevalinnainen
Tyyppienum
OletusX264 (.mp4)
X264 (.mp4)VP9 (.webm)PRORES4444 (.mov)GIF (.gif)
Tuloksena syntyvän videon tulostetyyppi.
video_qualityvalinnainen
Tyyppienum
Oletushigh
lowmediumhighmaximum
Tuloksena syntyvän videon laatutaso.
video_write_modevalinnainen
Tyyppienum
Oletusbalanced
fastbalancedsmall
Tuloksena syntyvän videon kirjoitustila.
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/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"
  }
}
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
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}Taustanpoiston jälkeinen video.
mask_video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames} | nullTaustanpoiston aikana käytetty maski.

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