رفتن به محتوا

Segment Anything Model 2 · Image

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

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

اشیا را در یک تصویر منفرد از روی اعلان‌های نقطه‌ای یا کادری بخش‌بندی می‌کند و ماسک یا تصویر ماسک‌شده را برمی‌گرداند

Meta · تصویر

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

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

ساخت درخواست

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

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

URL تصویر برای قطعه‌بندی.

پیشرفته output_format · apply_mask · prompts · box_prompts
output_format پیش‌فرض png

قالب فایل تصویر نهایی.

پیش‌فرض []

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

پیش‌فرض []

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

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

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

یک تصویر را با SAM 2 و با استفاده از اعلان‌های نقطه‌ای (`prompts`) یا مختصات کادر (`box_prompts`) بخش‌بندی می‌کند. `apply_mask` را روی true تنظیم کنید تا ماسک روی تصویر اعمال شود، نه اینکه فقط خود ماسک برگردد. خروجی را می‌توان به‌صورت jpeg، png یا webp ذخیره کرد؛ png پیش‌فرض است. هر درخواست یک URL تصویر می‌گیرد.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
image_urlالزامی image
نوع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
کنترل می‌کند که ماسک روی تصویر اعمال شود یا نه.
output_formatاختیاری
نوعenum
پیش‌فرضpng
jpegpngwebp
قالب فایل تصویر نهایی.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam2/image",
  "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
    }
  },
  "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}تصویر با بخش‌بندی اعمال‌شده.

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

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