رفتن به محتوا

Bria's VRMBG 3.0

یکپارچه‌سازی

شناسه مدل bria/video/background-removal/v3
# 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/bria/video/background-removal/v3?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

فایل‌هایی مانند نمونه: ⁨‎$۰٫۵۰⁩ ۵۰۰ اعتبار API فایل‌های شما پیش از اجرا اندازه‌گیری می‌شوند اجرای آن در این صفحه

دریافت کلید API
Bria AI حذف پس‌زمینه #video-to-video

نسخهٔ v3 حذف پس‌زمینهٔ ویدیو با خروجی رنگی یا شفاف و گزینهٔ برش خودکار و بزرگ‌نمایی

Bria AI · ویدیو

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

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

ساخت درخواست

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

•الزامی video_url
یک فایل بیندازید، یا

ویدیوی منبع برای حذف پس‌زمینه.

پیشرفته output_container_and_codec · background_color · preserve_audio · auto_zoom
پیش‌فرض webm_vp9

کانتینر و کدک مورد استفاده برای خروجی: mp4_h265، mp4_h264، webm_vp9، mov_h265، mov_proresks، mkv_h265، mkv_h264، mkv_vp9 یا gif.

پیش‌فرض Black

رنگ مورد استفاده برای پس‌زمینه: Transparent، Black، White، Gray، Red، Green، Blue، Yellow، Cyan، Magenta یا Orange.

POST /run/bria/video/background-removal/v3?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/bria/video/background-removal/v3?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

اجرای این درخواست

کلید شما در این مرورگر باقی می‌ماند: فقط به Doitong API ارسال می‌شود و فقط در صورت فعال‌کردن گزینه «یادآوری»، در localStorage ذخیره می‌شود. دریافت کلید API

درباره Bria's VRMBG 3.0

پس‌زمینهٔ ویدیوی ارائه‌شده در `video_url` را حذف می‌کند. `background_color` می‌تواند Transparent یا یکی از ده رنگ یکدست باشد. `auto_zoom` خروجی را به کوچک‌ترین مستطیل شامل سوژه در کل ویدیو برش می‌دهد. نه گزینهٔ کانتینر و کدک خروجی ارائه می‌شود و `preserve_audio` به‌طور پیش‌فرض فعال است.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
output_container_and_codecاختیاری
نوعenum
پیش‌فرضwebm_vp9
mp4_h265mp4_h264webm_vp9mov_h265mov_proresksmkv_h265mkv_h264mkv_vp9gif
کانتینر و کدک مورد استفاده برای خروجی: mp4_h265، mp4_h264، webm_vp9، mov_h265، mov_proresks، mkv_h265، mkv_h264، mkv_vp9 یا gif.
preserve_audioاختیاری
نوعboolean
پیش‌فرضtrue
وقتی مقدار true باشد، نگه‌داشتن صوت در ویدیوی خروجی فعال است.
video_urlالزامی video
نوعurl · video
ویدیوی منبع برای حذف پس‌زمینه.
background_colorاختیاری
نوعenum
پیش‌فرضBlack
TransparentBlackWhiteGrayRedGreenBlueYellowCyanMagentaOrange
رنگ مورد استفاده برای پس‌زمینه: Transparent، Black، White، Gray، Red، Green، Blue، Yellow، Cyan، Magenta یا Orange.
auto_zoomاختیاری
نوعboolean
پیش‌فرضfalse
کلید برش خودکار: true از موقعیت‌های سوژه در همه فریم‌های ویدیو برای یافتن کوچک‌ترین مستطیل محاط‌کننده استفاده می‌کند و خروجی را به آن برش می‌دهد.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاری‌شده را می‌پذیرند. فایل‌ها

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/video/background-removal/v3",
  "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": 500,
    "usd": "0.50",
    "charged": 500,
    "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
    },
    "request_id": "string",
    "warning": "string"
  },
  "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.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 شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
video
object {url, content_type, file_name, file_size}ویدیو پس از حذف پس‌زمینه و صوت آن.
request_id
stringشناسه درخواست Bria.
warning
string | nullهشداری که تنظیم پارامتری انجام‌شده هنگام پردازش درخواست را توصیف می‌کند. برای مثال، کدکی که از آلفا پشتیبانی نمی‌کند ممکن است به‌جای پس‌زمینه شفاف به رنگ سیاه نیاز داشته باشد.

مدل‌های بیشتر: حذف پس‌زمینه

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/bria/video/background-removal/v3.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt