Zum Inhalt springen

Birefnet

Integrieren

Modell-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"

Bis zu 2,07 $ pro Ausführung Nach tatsächlicher Nutzung abgerechnet, der Rest wird erstattet Auf dieser Seite ausführen

API-Schlüssel abrufen
BiRefNet Hintergrundentfernung #utility#editing

Entfernt Hintergründe aus Videos mit sechs Modelloptionen, Matting sowie mp4-, webm-, mov- oder gif-Ausgabe

BiRefNet · Video

Dein erstes Ergebnis erscheint hier

Erstelle unten eine Anfrage und führe sie mit deinem API-Schlüssel aus. Ausgaben werden in unseren Speicher kopiert und dauerhaft oder 7 Tage kostenlos aufbewahrt.

Anfrage erstellen

Die Steuerelemente werden aus dem Modellschema generiert. Code und Preis werden aktualisiert, während du sie änderst.

•erforderlich video_url
Datei ablegen oder

URL des Videos, dessen Hintergrund entfernt wird.

Erweitert operating_resolution · video_output_type · video_quality · video_write_mode · model · output_mask · refine_foreground
operating_resolution Standard 1024x1024

Arbeitsauflösung; '2304x2304' ist auf das Modell 'General Use (Dynamic)' beschränkt. Bei hochauflösenden Eingabebildern verbessern höhere Einstellungen die Ausgabequalität.

video_output_type Standard X264 (.mp4)

Ausgabetyp des resultierenden Videos.

video_quality Standard high

Qualitätsstufe des resultierenden Videos.

video_write_mode Standard balanced

Schreibmodus des resultierenden Videos.

Standard General Use (Light)

Auswahl des Modells zur Hintergrundentfernung: 'General Use (Light)' verweist auf BiRefNet, das ursprüngliche Modell des BiRefNet-Repositorys, und wird für die meisten Anwendungsfälle empfohlen. 'General Use (Light 2K)' verweist auf BiRefNet_lite-2K und verwendet dieses ursprüngliche, mit 2K-Bildern trainierte Modell. 'General Use (Heavy)' verweist auf BiRefNet_lite und bietet höhere Genauigkeit bei langsamerer Verarbeitung. 'Matting' verweist auf BiRefNet-matting und wurde speziell für Bild-Matting trainiert. 'Portrait' verweist auf BiRefNet-portrait und wurde speziell mit Porträtbildern trainiert. 'General Use (Dynamic)' verweist auf BiRefNet_dynamic und unterstützt variable Auflösungen von 256x256 bis 2304x2304.

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

Diese Anfrage ausführen

Dein Schlüssel bleibt in diesem Browser: Er wird nur an die Doitong API gesendet und nur gespeichert (localStorage), wenn du „Merken“ aktivierst. API-Schlüssel abrufen

Über Birefnet

Wendet die BiRefNet-Segmentierung auf jedes Bild eines Videos aus `video_url` an. Die Modelle umfassen Light, Light 2K, Heavy, Matting, Portrait und Dynamic, mit Betriebsauflösungen bis 2304x2304 (nur beim Modell Dynamic). Die Ausgabe kann X264 mp4, VP9 webm, ProRes 4444 mov oder GIF sein, mit den Einstellungen `video_quality` und `video_write_mode`. Ein separates Maskenvideo kann angefordert werden.

Parameter

Sende entweder den kanonischen Namen oder den nativen Namen, nicht beide. Kanonische Namen

NameTyp StandardZulässig Beschreibung
modeloptional
Typenum
StandardGeneral Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
Auswahl des Modells zur Hintergrundentfernung: 'General Use (Light)' verweist auf BiRefNet, das ursprüngliche Modell des BiRefNet-Repositorys, und wird für die meisten Anwendungsfälle empfohlen. 'General Use (Light 2K)' verweist auf BiRefNet_lite-2K und verwendet dieses ursprüngliche, mit 2K-Bildern trainierte Modell. 'General Use (Heavy)' verweist auf BiRefNet_lite und bietet höhere Genauigkeit bei langsamerer Verarbeitung. 'Matting' verweist auf BiRefNet-matting und wurde speziell für Bild-Matting trainiert. 'Portrait' verweist auf BiRefNet-portrait und wurde speziell mit Porträtbildern trainiert. 'General Use (Dynamic)' verweist auf BiRefNet_dynamic und unterstützt variable Auflösungen von 256x256 bis 2304x2304.
operating_resolutionoptional
Typenum
Standard1024x1024
1024x10242048x20482304x2304
Arbeitsauflösung; '2304x2304' ist auf das Modell 'General Use (Dynamic)' beschränkt. Bei hochauflösenden Eingabebildern verbessern höhere Einstellungen die Ausgabequalität.
output_maskoptional
Typboolean
Standardfalse
Steuert, ob die Maske zur Hintergrundentfernung in der Ausgabe enthalten ist.
refine_foregroundoptional
Typboolean
Standardtrue
Steuert die Vordergrundverfeinerung auf Grundlage der geschätzten Maske.
video_urlerforderlich video
Typurl · video
URL des Videos, dessen Hintergrund entfernt wird.
video_output_typeoptional
Typenum
StandardX264 (.mp4)
X264 (.mp4)VP9 (.webm)PRORES4444 (.mov)GIF (.gif)
Ausgabetyp des resultierenden Videos.
video_qualityoptional
Typenum
Standardhigh
lowmediumhighmaximum
Qualitätsstufe des resultierenden Videos.
video_write_modeoptional
Typenum
Standardbalanced
fastbalancedsmall
Schreibmodus des resultierenden Videos.
erforderlich Kanonischer Name, ebenfalls akzeptiert

Dateiparameter akzeptieren eine öffentliche https://-URL, eine data:-URI bis 10 MB oder die file_url eines Uploads. Dateien

Ausgabe

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"
  }
}
Deine Dateien, deine EntscheidungJede outputs[].url ist eine Kopie in unserem Speicher: dauerhaft aufbewahrt (Abrechnung pro GB-Monat) oder 7 Tage kostenlos – je nach Kontoeinstellung oder ?storage=.
Gleiche Struktur bei jedem Modelltype, url, content_type, width, height und duration – für Bilder, Video und Audio gleichermaßen. output ist das Ergebnisobjekt des Modells.
Ausgabefelder
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}Video nach der Hintergrundentfernung.
mask_video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames} | nullBei der Hintergrundentfernung angewendete Maske.

Für KI-Agenten: Diese Seite ist als Markdown verfügbar unter https://doitong.com/de/developers/models/birefnet/v2/video.md. Alle Modelle und Anleitungen: https://doitong.com/developers/llms.txt