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

BiRefNet V2 Background Removal

التكامل

معرّف النموذج birefnet/v2
# 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?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
  }'

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

هذا الطلب: ≈⁨‏0.002 $⁩ 2 رصيدا API تشغيله في هذه الصفحة

الحصول على مفتاح API
BiRefNet إزالة الخلفية #cutout#matting#open-weights

إزالة الخلفية وتفريغ الصورة حتى 2304 px، مع إخراج قناع اختياري.

BiRefNet · صورة

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

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

إنشاء طلب

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

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

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

متقدم operating_resolution · output_format · model · output_mask · refine_foreground · mask_only
operating_resolution الافتراضي 1024x1024

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

output_format الافتراضي png

تنسيق الصورة الناتجة.

الافتراضي 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?wait=20 عرض السعر → ⁨‏0.002 $⁩
# 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?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
  }'

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

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

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

حول BiRefNet V2 Background Removal

يفصل BiRefNet V2 الموضوع عن الخلفية باستخدام عدة تنويعات للنموذج (light, heavy, matting، portrait, dynamic) ودقات تشغيل تصل إلى 2304x2304. يعيد الصورة المفرغة، والقناع اختياريًا، بصيغ PNG أو WebP أو GIF.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
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
تتحكم في تحسين المقدمة استناداً إلى القناع المقدّر.
image_urlمطلوب image
النوعurl · image
عنوان URL الذي يحدد الصورة التي ستُزال خلفيتها.
output_formatاختياري
النوعenum
الافتراضيpng
webppnggif
تنسيق الصورة الناتجة.
mask_onlyاختياري
النوعboolean
الافتراضيfalse
مفتاح إخراج القناع فقط: يتجاوز `True` تحسين المقدمة ويترك الصورة دون تغيير، مع إرجاع قناع التجزئة فقط. عند الحاجة إلى القناع وحده، يتجنب ذلك الحساب الإضافي ويقلل البيانات المنقولة.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "birefnet/v2",
  "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": 2,
    "usd": "0.002",
    "charged": 2,
    "refunded": 0
  },
  "input": {
    "image": "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    },
    "mask_image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    }
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "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"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
image
object {url, content_type, file_name, file_size, width, height}الصورة بعد إزالة الخلفية، أو قناع التجزئة عندما تكون `mask_only` هي `True`.
mask_image
object {url, content_type, file_name, file_size, width, height} | nullالقناع المطبق أثناء إزالة الخلفية.

مزيد من النماذج: إزالة الخلفية

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