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

Birefnet Background Removal

التكامل

معرّف النموذج birefnet
# 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?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.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 إزالة الخلفية #background-removal#segmentation#high-res#utility

يزيل الخلفية من صورة واحدة، مع خيارات فاتح وثقيل وصورة شخصية وإخراج قناع اختياري

BiRefNet · صورة

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

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

إنشاء طلب

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

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

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

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

تتحكم دقة المعالجة في الدقة على الصور المصدر عالية الدقة؛ ويؤدي اختيار دقة أكبر إلى تحسين تلك الدقة.

output_format الافتراضي png

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

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

اختيار نموذج إزالة الخلفية: يطابق 'General Use (Light)' النموذج BiRefNet-DIS_ep580.pth، وهو النموذج الأصلي لمستودع BiRefNet، ويوصى به لمعظم الاستخدامات. يطابق 'General Use (Heavy)' النموذج BiRefNet-massive-epoch_240.pth ويوفر دقة أعلى مع معالجة أبطأ. يطابق 'Portrait' النموذج BiRefNet-portrait-TR_P3M_10k-epoch_120.pth، وهو مدرّب خصيصاً على صور البورتريه.

POST /run/birefnet?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?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.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 Background Removal

يقسّم المقدمة في صورة واحدة محددة عبر `image_url` ويعيدها بعد إزالة الخلفية. يوفّر الخيار `model` الخيارات General Use (Light) وGeneral Use (Heavy) وPortrait. يمكن أن تكون `operating_resolution` هي 1024x1024 أو 2048x2048 للمدخلات الأعلى دقة. يمكنك أيضًا إعادة القناع باستخدام `output_mask` واختيار إخراج png أو webp أو gif.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
modelاختياري
النوعenum
الافتراضيGeneral Use (Light)
General Use (Light)General Use (Heavy)Portrait
اختيار نموذج إزالة الخلفية: يطابق 'General Use (Light)' النموذج BiRefNet-DIS_ep580.pth، وهو النموذج الأصلي لمستودع BiRefNet، ويوصى به لمعظم الاستخدامات. يطابق 'General Use (Heavy)' النموذج BiRefNet-massive-epoch_240.pth ويوفر دقة أعلى مع معالجة أبطأ. يطابق 'Portrait' النموذج BiRefNet-portrait-TR_P3M_10k-epoch_120.pth، وهو مدرّب خصيصاً على صور البورتريه.
operating_resolutionاختياري
النوعenum
الافتراضي1024x1024
1024x10242048x2048
تتحكم دقة المعالجة في الدقة على الصور المصدر عالية الدقة؛ ويؤدي اختيار دقة أكبر إلى تحسين تلك الدقة.
output_maskاختياري
النوعboolean
الافتراضيfalse
تحدد ما إذا كان قناع إزالة الخلفية سيُضمّن في المخرج.
refine_foregroundاختياري
النوعboolean
الافتراضيtrue
تتحكم في تحسين المقدمة استناداً إلى القناع المقدّر.
image_urlمطلوب image
النوعurl · image
عنوان URL الذي يحدد الصورة التي ستُزال خلفيتها.
output_formatاختياري
النوعenum
الافتراضيpng
webppnggif
تنسيق الصورة الناتجة.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "birefnet",
  "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_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.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_image
object {url, content_type, file_name, file_size, width, height} | nullالقناع المطبق أثناء إزالة الخلفية.

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

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