رفتن به محتوا

Segment Anything Model 2 · Video

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

شناسه مدل sam2/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/sam2/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
Meta ویدیو به ویدیو #segmentation#mask#real-time

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

Meta · ویدیو

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

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

ساخت درخواست

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

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

URL ویدیو برای بخش‌بندی.

پیشرفته mask · apply_mask · boundingbox_zip · prompts · box_prompts
mask_url
یک فایل بیندازید، یا

URL ماسک برای اعمال اولیه.

پیش‌فرض []

پرامپت‌های مورد استفاده برای بخش‌بندی ویدیو.

پیش‌فرض []

مختصات مرز کادر.

POST /run/sam2/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/sam2/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

درباره Segment Anything Model 2 · Video

یک ویدیو را با SAM 2 بخش‌بندی می‌کند. آن را با `prompts` یا `box_prompts` هدایت کنید، یا از طریق `mask_url` یک ماسک اولیه ارائه دهید. `apply_mask` ماسک را روی ویدیوی خروجی قرار می‌دهد. `boundingbox_zip` را فعال کنید تا پوشش‌های کادر محدودکنندهٔ هر فریم را نیز به‌صورت آرشیو zip دریافت کنید.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
video_urlالزامی video
نوعurl · video
URL ویدیو برای بخش‌بندی.
mask_urlاختیاری mask
نوعurl · image
URL ماسک برای اعمال اولیه.
promptsاختیاری
نوعobject[]
پیش‌فرض[]
پرامپت‌های مورد استفاده برای بخش‌بندی ویدیو.
prompts[].xاختیاری
نوعinteger
پیش‌فرض305
موقعیت پرامپت روی محور X.
prompts[].yاختیاری
نوعinteger
پیش‌فرض350
موقعیت پرامپت روی محور Y.
prompts[].labelاختیاری
نوعenum
پیش‌فرض1
01
برچسب پرامپت: 1 نشان‌دهندهٔ پیش‌زمینه و 0 نشان‌دهندهٔ پس‌زمینه است.
prompts[].frame_indexاختیاری
نوعinteger
پیش‌فرض0
شاخص شناسایی‌کننده فریم برای تعامل.
box_promptsاختیاری
نوعobject[]
پیش‌فرض[]
مختصات مرز کادر.
box_prompts[].x_minاختیاری
نوعinteger
پیش‌فرض0
کمینهٔ مختصات x برای کادر.
box_prompts[].y_minاختیاری
نوعinteger
پیش‌فرض0
کمینهٔ مختصات y برای کادر.
box_prompts[].x_maxاختیاری
نوعinteger
پیش‌فرض0
بیشینهٔ مختصات x برای پرامپت.
box_prompts[].y_maxاختیاری
نوعinteger
پیش‌فرض0
بیشینهٔ مختصات y برای پرامپت.
box_prompts[].frame_indexاختیاری
نوعinteger
پیش‌فرض0
شاخص شناسایی‌کننده فریم برای تعامل.
apply_maskاختیاری
نوعboolean
پیش‌فرضfalse
اینکه ماسک‌گذاری روی ویدیو اعمال شود یا نه.
boundingbox_zipاختیاری
نوعboolean
پیش‌فرضfalse
اینکه بایگانی ZIP شامل پوشش‌های کادر محدودکننده برای هر فریم بازگردانده شود یا نه.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam2/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": 4000,
    "usd": "4.00",
    "charged": 4000,
    "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
    },
    "boundingbox_frames_zip": {
      "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
    }
  },
  "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}ویدیوی تولیدشده از بخش‌بندی.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullبایگانی ZIP پوشش‌های کادر محدودکننده برای هر فریم.

مدل‌های بیشتر: ویدیو به ویدیو

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