رفتن به محتوا

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"

تا ⁨‎$۲٫۰۷⁩ برای هر اجرا بر اساس مصرف واقعی هزینه دریافت می‌شود و مابقی بازپرداخت می‌شود اجرای آن در این صفحه

دریافت کلید API
BiRefNet حذف پس‌زمینه #utility#editing

پس‌زمینه را از ویدیو حذف می‌کند؛ با شش گزینه مدل، ماتینگ و خروجی mp4، webm، mov یا gif

BiRefNet · ویدیو

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

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

ساخت درخواست

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

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