Langkau ke kandungan

Birefnet

Integrasikan

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

Sehingga $2.07 setiap larian dicaj berdasarkan penggunaan sebenar, selebihnya dibayar balik Jalankan pada halaman ini

Dapatkan kunci API
BiRefNet Pembuangan Latar Belakang #utility#editing

Membuang latar belakang daripada video, dengan enam pilihan model, matting serta output mp4, webm, mov atau gif

BiRefNet · Video

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan video_url
Lepaskan fail, atau

URL yang mengenal pasti video yang latar belakangnya akan dibuang.

Lanjutan operating_resolution · video_output_type · video_quality · video_write_mode · model · output_mask · refine_foreground
operating_resolution lalai 1024x1024

Resolusi kerja, dengan '2304x2304' terhad kepada model 'General Use (Dynamic)'. Untuk imej input beresolusi tinggi, tetapan lebih tinggi meningkatkan ketepatan output.

video_output_type lalai X264 (.mp4)

Jenis output untuk video yang terhasil.

video_quality lalai high

Tahap kualiti untuk video yang terhasil.

video_write_mode lalai balanced

Mod penulisan untuk video yang terhasil.

lalai General Use (Light)

Pemilihan model pembuangan latar belakang: 'General Use (Light)' dipetakan kepada BiRefNet, model asal repositori BiRefNet dan disyorkan untuk kebanyakan penggunaan. 'General Use (Light 2K)' dipetakan kepada BiRefNet_lite-2K dan menggunakan model asal yang dilatih pada imej 2K. 'General Use (Heavy)' dipetakan kepada BiRefNet_lite dan memberikan ketepatan lebih tinggi dengan pemprosesan lebih perlahan. 'Matting' dipetakan kepada BiRefNet-matting dan dilatih khusus untuk pemattingan imej. 'Portrait' dipetakan kepada BiRefNet-portrait dan dilatih khusus pada imej potret. 'General Use (Dynamic)' dipetakan kepada BiRefNet_dynamic dan menyokong resolusi berubah dari 256x256 hingga 2304x2304.

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

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Birefnet

Menggunakan pembahagian BiRefNet pada setiap bingkai video daripada `video_url`. Model termasuk Light, Light 2K, Heavy, Matting, Portrait dan Dynamic, dengan resolusi operasi sehingga 2304x2304 (hanya untuk model Dynamic). Output boleh berupa X264 mp4, VP9 webm, ProRes 4444 mov atau GIF, dengan tetapan `video_quality` dan `video_write_mode`. Video topeng berasingan juga boleh diminta.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
modelpilihan
Jenisenum
LalaiGeneral Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
Pemilihan model pembuangan latar belakang: 'General Use (Light)' dipetakan kepada BiRefNet, model asal repositori BiRefNet dan disyorkan untuk kebanyakan penggunaan. 'General Use (Light 2K)' dipetakan kepada BiRefNet_lite-2K dan menggunakan model asal yang dilatih pada imej 2K. 'General Use (Heavy)' dipetakan kepada BiRefNet_lite dan memberikan ketepatan lebih tinggi dengan pemprosesan lebih perlahan. 'Matting' dipetakan kepada BiRefNet-matting dan dilatih khusus untuk pemattingan imej. 'Portrait' dipetakan kepada BiRefNet-portrait dan dilatih khusus pada imej potret. 'General Use (Dynamic)' dipetakan kepada BiRefNet_dynamic dan menyokong resolusi berubah dari 256x256 hingga 2304x2304.
operating_resolutionpilihan
Jenisenum
Lalai1024x1024
1024x10242048x20482304x2304
Resolusi kerja, dengan '2304x2304' terhad kepada model 'General Use (Dynamic)'. Untuk imej input beresolusi tinggi, tetapan lebih tinggi meningkatkan ketepatan output.
output_maskpilihan
Jenisboolean
Lalaifalse
Mengawal sama ada topeng pembuangan latar belakang disertakan dalam output.
refine_foregroundpilihan
Jenisboolean
Lalaitrue
Mengawal penambahbaikan latar hadapan berdasarkan topeng yang dianggarkan.
video_urldiperlukan video
Jenisurl · video
URL yang mengenal pasti video yang latar belakangnya akan dibuang.
video_output_typepilihan
Jenisenum
LalaiX264 (.mp4)
X264 (.mp4)VP9 (.webm)PRORES4444 (.mov)GIF (.gif)
Jenis output untuk video yang terhasil.
video_qualitypilihan
Jenisenum
Lalaihigh
lowmediumhighmaximum
Tahap kualiti untuk video yang terhasil.
video_write_modepilihan
Jenisenum
Lalaibalanced
fastbalancedsmall
Mod penulisan untuk video yang terhasil.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}Video selepas latar belakang dibuang.
mask_video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames} | nullTopeng yang digunakan semasa pembuangan latar belakang.

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/birefnet/v2/video.md. Semua model dan panduan: https://doitong.com/developers/llms.txt