Przejdź do treści

Birefnet

Integracja

Identyfikator modelu 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"

Do 2,07 $ za uruchomienie opłata jest naliczana za rzeczywiste wykorzystanie, a reszta jest zwracana Uruchom na tej stronie

Uzyskaj klucz API
BiRefNet Usuwanie tła #utility#editing

Usuwa tło z wideo, oferując sześć modeli, matting oraz wyjście mp4, webm, mov lub gif

BiRefNet · Wideo

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

•wymagane video_url
Upuść plik lub

URL wideo, którego tło zostanie usunięte.

Zaawansowane operating_resolution · video_output_type · video_quality · video_write_mode · model · output_mask · refine_foreground
operating_resolution domyślnie 1024x1024

Rozdzielczość robocza; '2304x2304' jest dostępna wyłącznie dla modelu 'General Use (Dynamic)'. W przypadku danych wejściowych o wysokiej rozdzielczości wyższe ustawienia poprawiają dokładność wyniku.

video_output_type domyślnie X264 (.mp4)

Typ wynikowego wideo.

video_quality domyślnie high

Poziom jakości wynikowego wideo.

video_write_mode domyślnie balanced

Tryb zapisu wynikowego wideo.

domyślnie General Use (Light)

Wybór modelu usuwania tła: 'General Use (Light)' wskazuje BiRefNet, oryginalny model z repozytorium BiRefNet, zalecany do większości zastosowań. 'General Use (Light 2K)' wskazuje BiRefNet_lite-2K, oryginalny model trenowany na obrazach 2K. 'General Use (Heavy)' wskazuje BiRefNet_lite i zapewnia większą dokładność kosztem wolniejszego przetwarzania. 'Matting' wskazuje BiRefNet-matting, trenowany specjalnie do matowania obrazów. 'Portrait' wskazuje BiRefNet-portrait, trenowany specjalnie na obrazach portretowych. 'General Use (Dynamic)' wskazuje BiRefNet_dynamic i obsługuje rozdzielczości od 256x256 do 2304x2304.

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

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o Birefnet

Stosuje segmentację BiRefNet do każdej klatki wideo z `video_url`. Modele obejmują Light, Light 2K, Heavy, Matting, Portrait i Dynamic, z rozdzielczościami działania do 2304x2304 (tylko dla modelu Dynamic). Wynik może być w formacie X264 mp4, VP9 webm, ProRes 4444 mov lub GIF, z ustawieniami `video_quality` i `video_write_mode`. Można zażądać osobnego wideo maski.

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis
modelopcjonalne
Typenum
DomyślneGeneral Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
Wybór modelu usuwania tła: 'General Use (Light)' wskazuje BiRefNet, oryginalny model z repozytorium BiRefNet, zalecany do większości zastosowań. 'General Use (Light 2K)' wskazuje BiRefNet_lite-2K, oryginalny model trenowany na obrazach 2K. 'General Use (Heavy)' wskazuje BiRefNet_lite i zapewnia większą dokładność kosztem wolniejszego przetwarzania. 'Matting' wskazuje BiRefNet-matting, trenowany specjalnie do matowania obrazów. 'Portrait' wskazuje BiRefNet-portrait, trenowany specjalnie na obrazach portretowych. 'General Use (Dynamic)' wskazuje BiRefNet_dynamic i obsługuje rozdzielczości od 256x256 do 2304x2304.
operating_resolutionopcjonalne
Typenum
Domyślne1024x1024
1024x10242048x20482304x2304
Rozdzielczość robocza; '2304x2304' jest dostępna wyłącznie dla modelu 'General Use (Dynamic)'. W przypadku danych wejściowych o wysokiej rozdzielczości wyższe ustawienia poprawiają dokładność wyniku.
output_maskopcjonalne
Typboolean
Domyślnefalse
Określa, czy maska usuwania tła jest dołączana do wyniku.
refine_foregroundopcjonalne
Typboolean
Domyślnetrue
Określa udoskonalanie pierwszego planu na podstawie oszacowanej maski.
video_urlwymagane video
Typurl · video
URL wideo, którego tło zostanie usunięte.
video_output_typeopcjonalne
Typenum
DomyślneX264 (.mp4)
X264 (.mp4)VP9 (.webm)PRORES4444 (.mov)GIF (.gif)
Typ wynikowego wideo.
video_qualityopcjonalne
Typenum
Domyślnehigh
lowmediumhighmaximum
Poziom jakości wynikowego wideo.
video_write_modeopcjonalne
Typenum
Domyślnebalanced
fastbalancedsmall
Tryb zapisu wynikowego wideo.
wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

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"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}Wideo po usunięciu tła.
mask_video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames} | nullMaska zastosowana podczas usuwania tła.

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/birefnet/v2/video.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt