رفتن به محتوا

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"

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

دریافت کلید API
BiRefNet حذف پس‌زمینه #background-removal#segmentation#high-res#utility

پس‌زمینه را از یک تصویر حذف می‌کند؛ با گونه‌های سبک، سنگین یا پرتره و خروجی اختیاری ماسک

BiRefNet · تصویر

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

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

ساخت درخواست

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

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