تخطّي إلى المحتوى

Birefnet

التكامل

معرّف النموذج 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

حتى ⁨‏2.07 $⁩ لكل تشغيل تُحتسب التكلفة حسب الاستخدام الفعلي، ويُسترد الباقي تشغيله في هذه الصفحة

الحصول على مفتاح API
BiRefNet إزالة الخلفية #utility#editing

يزيل الخلفيات من الفيديو، مع ستة خيارات للنموذج، وإخراج matting وmp4 أو webm أو mov أو gif

BiRefNet · فيديو

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب video_url
أفلت ملفًا، أو

عنوان URL الذي يحدد الفيديو الذي ستُزال خلفيته.

متقدم operating_resolution · video_output_type · video_quality · video_write_mode · model · output_mask · refine_foreground
operating_resolution الافتراضي 1024x1024

دقة العمل، مع قصر '2304x2304' على نموذج 'General Use (Dynamic)'. بالنسبة إلى الصور المدخلة عالية الدقة، تحسن الإعدادات الأعلى دقة المخرج.

video_output_type الافتراضي X264 (.mp4)

نوع مخرج الفيديو الناتج.

video_quality الافتراضي high

مستوى جودة الفيديو الناتج.

video_write_mode الافتراضي balanced

وضع كتابة الفيديو الناتج.

الافتراضي General Use (Light)

اختيار نموذج إزالة الخلفية: يطابق 'General Use (Light)' نموذج BiRefNet، وهو النموذج الأصلي لمستودع BiRefNet ويوصى به لمعظم الاستخدامات. يطابق 'General Use (Light 2K)' نموذج BiRefNet_lite-2K، وهو النموذج الأصلي المدرّب على صور 2K. يطابق 'General Use (Heavy)' نموذج BiRefNet_lite ويوفر دقة أعلى مع معالجة أبطأ. يطابق 'Matting' نموذج BiRefNet-matting، وهو مدرّب خصيصاً لمعالجة الصور بالقناع. يطابق 'Portrait' نموذج BiRefNet-portrait، وهو مدرّب خصيصاً على صور البورتريه. يطابق 'General Use (Dynamic)' نموذج BiRefNet_dynamic ويدعم دقات متغيرة من 256x256 إلى 2304x2304.

POST /run/birefnet/v2/video?wait=20 عرض السعر → ⁨‏2.07 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Birefnet

يطبّق تجزئة BiRefNet على كل إطار من فيديو مصدره `video_url`. تشمل النماذج Light وLight 2K وHeavy وMatting وPortrait وDynamic، بدقات تشغيل تصل إلى 2304x2304 (لنموذج Dynamic فقط). يمكن أن يكون الناتج X264 mp4 أو VP9 webm أو ProRes 4444 mov أو GIF، مع إعدادَي `video_quality` و`video_write_mode`. ويمكن طلب فيديو قناع منفصل.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
modelاختياري
النوعenum
الافتراضيGeneral Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
اختيار نموذج إزالة الخلفية: يطابق 'General Use (Light)' نموذج BiRefNet، وهو النموذج الأصلي لمستودع BiRefNet ويوصى به لمعظم الاستخدامات. يطابق 'General Use (Light 2K)' نموذج BiRefNet_lite-2K، وهو النموذج الأصلي المدرّب على صور 2K. يطابق 'General Use (Heavy)' نموذج BiRefNet_lite ويوفر دقة أعلى مع معالجة أبطأ. يطابق 'Matting' نموذج BiRefNet-matting، وهو مدرّب خصيصاً لمعالجة الصور بالقناع. يطابق 'Portrait' نموذج BiRefNet-portrait، وهو مدرّب خصيصاً على صور البورتريه. يطابق 'General Use (Dynamic)' نموذج BiRefNet_dynamic ويدعم دقات متغيرة من 256x256 إلى 2304x2304.
operating_resolutionاختياري
النوعenum
الافتراضي1024x1024
1024x10242048x20482304x2304
دقة العمل، مع قصر '2304x2304' على نموذج 'General Use (Dynamic)'. بالنسبة إلى الصور المدخلة عالية الدقة، تحسن الإعدادات الأعلى دقة المخرج.
output_maskاختياري
النوعboolean
الافتراضيfalse
تحدد ما إذا كان قناع إزالة الخلفية سيُضمّن في المخرج.
refine_foregroundاختياري
النوعboolean
الافتراضيtrue
تتحكم في تحسين المقدمة استناداً إلى القناع المقدّر.
video_urlمطلوب video
النوعurl · video
عنوان URL الذي يحدد الفيديو الذي ستُزال خلفيته.
video_output_typeاختياري
النوعenum
الافتراضيX264 (.mp4)
X264 (.mp4)VP9 (.webm)PRORES4444 (.mov)GIF (.gif)
نوع مخرج الفيديو الناتج.
video_qualityاختياري
النوعenum
الافتراضيhigh
lowmediumhighmaximum
مستوى جودة الفيديو الناتج.
video_write_modeاختياري
النوعenum
الافتراضيbalanced
fastbalancedsmall
وضع كتابة الفيديو الناتج.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}الفيديو بعد إزالة الخلفية.
mask_video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames} | nullالقناع المطبق أثناء إزالة الخلفية.

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/birefnet/v2/video.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt