رفتن به محتوا

Ben-Video-Bg-Rm

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

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

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

دریافت کلید API
Open model حذف پس‌زمینه #segmentation#background-removal

پس‌زمینهٔ ویدیو را حذف می‌کند و خروجی webm شفاف یا زمینهٔ یکدست RGB ارائه می‌دهد

Open model · ویدیو

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

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

ساخت درخواست

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

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

URL شناسایی‌کننده ویدیویی که پس‌زمینه آن حذف می‌شود.

پیشرفته output_format · seed · background_color
output_format پیش‌فرض mp4

قالب ویدیوی خروجی؛ MP4 نواحی شفاف را به‌دلیل نداشتن پشتیبانی از شفافیت، سیاه نمایش می‌دهد. برای شفافیت واقعی، "webm" از VP9 با کانال آلفا استفاده می‌کند.

seed تصادفی که تولید تکرارپذیر را ممکن می‌کند.

رنگ پس‌زمینه اختیاری که به‌صورت مقادیر RGB از 0 تا 255 مشخص می‌شود؛ برای مثال [0, 0, 0]. حذف این مقدار پس‌زمینه‌ای شفاف ایجاد می‌کند.

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

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

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

درباره Ben-Video-Bg-Rm

یک کلیپ از `video_url` را پردازش می‌کند. بدون `background_color`، پس‌زمینه شفاف است؛ در غیر این صورت سه مقدار RGB از 0 تا 255 ارائه دهید. `output_format` برابر mp4 یا webm است و فقط webm شفافیت واقعی را حفظ می‌کند، زیرا mp4 آن را سیاه رندر می‌کند.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
video_urlالزامی video
نوعurl · video
URL شناسایی‌کننده ویدیویی که پس‌زمینه آن حذف می‌شود.
background_colorاختیاری
نوعany[]
≤ ۳ مورد≥ ۳ مورد
رنگ پس‌زمینه اختیاری که به‌صورت مقادیر RGB از 0 تا 255 مشخص می‌شود؛ برای مثال [0, 0, 0]. حذف این مقدار پس‌زمینه‌ای شفاف ایجاد می‌کند.
output_formatاختیاری
نوعenum
پیش‌فرضmp4
mp4webm
قالب ویدیوی خروجی؛ MP4 نواحی شفاف را به‌دلیل نداشتن پشتیبانی از شفافیت، سیاه نمایش می‌دهد. برای شفافیت واقعی، "webm" از VP9 با کانال آلفا استفاده می‌کند.
seedاختیاری
نوعinteger | null
seed تصادفی که تولید تکرارپذیر را ممکن می‌کند.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ben/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": 277,
    "usd": "0.277",
    "charged": 277,
    "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
    },
    "seed": 42
  },
  "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}فایل ویدیویی تولیدشده.
seed
integerSeed تولید تصویر، شامل مقدار تصادفی انتخاب‌شده در صورت حذف Seed از ورودی؛ در غیر این صورت، مقدار ارائه‌شده را تکرار می‌کند.

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

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