Naar inhoud springen

Birefnet

Integreren

Model-ID 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"

Tot $ 2,07 per uitvoering gefactureerd op basis van het werkelijke gebruik, de rest wordt terugbetaald Op deze pagina uitvoeren

API-sleutel ophalen
BiRefNet Achtergrond verwijderen #utility#editing

Verwijdert achtergronden uit video met zes modelkeuzes, matting en uitvoer als mp4, webm, mov of gif

BiRefNet · Video

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

•verplicht video_url
Sleep een bestand hierheen of

URL die de video identificeert waarvan de achtergrond wordt verwijderd.

Geavanceerd operating_resolution · video_output_type · video_quality · video_write_mode · model · output_mask · refine_foreground
operating_resolution standaard 1024x1024

Werkresolutie, waarbij '2304x2304' is beperkt tot het model 'General Use (Dynamic)'. Bij invoerafbeeldingen met hoge resolutie verbeteren hogere instellingen de uitvoernauwkeurigheid.

video_output_type standaard X264 (.mp4)

Uitvoertype van de resulterende video.

video_quality standaard high

Kwaliteitsniveau van de resulterende video.

video_write_mode standaard balanced

Schrijfmodus van de resulterende video.

standaard General Use (Light)

Selectie van het model voor achtergrondverwijdering: 'General Use (Light)' verwijst naar BiRefNet, het oorspronkelijke model van de BiRefNet-repository, aanbevolen voor de meeste toepassingen. 'General Use (Light 2K)' verwijst naar BiRefNet_lite-2K, het oorspronkelijke model dat op 2K-afbeeldingen is getraind. 'General Use (Heavy)' verwijst naar BiRefNet_lite en biedt hogere nauwkeurigheid met tragere verwerking. 'Matting' verwijst naar BiRefNet-matting en is specifiek getraind voor afbeelding matting. 'Portrait' verwijst naar BiRefNet-portrait en is specifiek getraind op portretafbeeldingen. 'General Use (Dynamic)' verwijst naar BiRefNet_dynamic en ondersteunt variabele resoluties van 256x256 tot 2304x2304.

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

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over Birefnet

Past BiRefNet-segmentatie toe op elk frame van een video vanuit `video_url`. Modellen zijn Light, Light 2K, Heavy, Matting, Portrait en Dynamic, met werkresoluties tot 2304x2304 (alleen voor het model Dynamic). De uitvoer kan X264 mp4, VP9 webm, ProRes 4444 mov of GIF zijn, met instellingen voor `video_quality` en `video_write_mode`. Een afzonderlijke maskervideo kan worden opgevraagd.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
modeloptioneel
Typeenum
StandaardGeneral Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
Selectie van het model voor achtergrondverwijdering: 'General Use (Light)' verwijst naar BiRefNet, het oorspronkelijke model van de BiRefNet-repository, aanbevolen voor de meeste toepassingen. 'General Use (Light 2K)' verwijst naar BiRefNet_lite-2K, het oorspronkelijke model dat op 2K-afbeeldingen is getraind. 'General Use (Heavy)' verwijst naar BiRefNet_lite en biedt hogere nauwkeurigheid met tragere verwerking. 'Matting' verwijst naar BiRefNet-matting en is specifiek getraind voor afbeelding matting. 'Portrait' verwijst naar BiRefNet-portrait en is specifiek getraind op portretafbeeldingen. 'General Use (Dynamic)' verwijst naar BiRefNet_dynamic en ondersteunt variabele resoluties van 256x256 tot 2304x2304.
operating_resolutionoptioneel
Typeenum
Standaard1024x1024
1024x10242048x20482304x2304
Werkresolutie, waarbij '2304x2304' is beperkt tot het model 'General Use (Dynamic)'. Bij invoerafbeeldingen met hoge resolutie verbeteren hogere instellingen de uitvoernauwkeurigheid.
output_maskoptioneel
Typeboolean
Standaardfalse
Bepaalt of het masker voor achtergrondverwijdering in de uitvoer wordt opgenomen.
refine_foregroundoptioneel
Typeboolean
Standaardtrue
Bepaalt verfijning van de voorgrond op basis van het geschatte masker.
video_urlverplicht video
Typeurl · video
URL die de video identificeert waarvan de achtergrond wordt verwijderd.
video_output_typeoptioneel
Typeenum
StandaardX264 (.mp4)
X264 (.mp4)VP9 (.webm)PRORES4444 (.mov)GIF (.gif)
Uitvoertype van de resulterende video.
video_qualityoptioneel
Typeenum
Standaardhigh
lowmediumhighmaximum
Kwaliteitsniveau van de resulterende video.
video_write_modeoptioneel
Typeenum
Standaardbalanced
fastbalancedsmall
Schrijfmodus van de resulterende video.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

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"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}Video na achtergrondverwijdering.
mask_video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames} | nullMasker dat tijdens achtergrondverwijdering is toegepast.

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/birefnet/v2/video.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt