رفتن به محتوا

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"

این درخواست: ≈⁨‎$۰٫۰۰۲⁩ ۲ اعتبار API اجرای آن در این صفحه

دریافت کلید API
BiRefNet حذف پس‌زمینه #cutout#matting#open-weights

حذف پس‌زمینه و ماتینگ متن‌باز تا 2304 px، با خروجی اختیاری ماسک.

BiRefNet · تصویر

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی 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 قیمت → ⁨‎$۰٫۰۰۲⁩
# 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 کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?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/fa/developers/models/birefnet/v2.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt