رفتن به محتوا

Sam 3 1 · Image RLE

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

شناسه مدل sam-3-1/image-rle
# 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/sam-3-1/image-rle?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

قطعه‌بندی تصویر با SAM 3.1 که ماسک‌ها را به‌صورت رمزگذاری طول اجرا ارائه می‌دهد

Meta · داده (JSON)

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

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

ساخت درخواست

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

پیش‌فرض wheel

دستور متنی برای هدایت قطعه‌بندی.

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

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

پیشرفته output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts
output_format پیش‌فرض png

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

پیش‌فرض 3

حد بالای ماسک‌های بازگردانده‌شده هنگام فعال‌بودن `return_multiple_masks`.

پیش‌فرض []

مجموعه‌ای از پرامپت‌های مبتنی بر نقطه.

پیش‌فرض []

پرامپت‌های جعبه‌ای که object_id آن‌ها گروه‌بندی را تعیین می‌کند: شناسه‌های یکسان جعبه‌ها را به یک شیء مرتبط می‌کنند و شناسه‌های خالی نشان‌دهنده اشیای جداگانه‌اند. چند جعبه را می‌توان با مختصات (x_min, y_min, x_max, y_max) ارائه کرد.

POST /run/sam-3-1/image-rle?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/sam-3-1/image-rle?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

درباره Sam 3 1 · Image RLE

قطعه‌بندی SAM 3.1 را روی تصویری با `prompt` متنی، نقاط یا کادرها اجرا می‌کند و ماسک‌ها را به‌جای فایل تصویر، به‌صورت داده RLE برمی‌گرداند. از چند ماسک (`max_masks` از 1 تا 32)، امتیازهای اطمینان و کادرهای محدودکننده در صورت درخواست پشتیبانی می‌کند.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
image_urlالزامی image
نوعurl · image
URL تصویر برای قطعه‌بندی.
promptاختیاری
نوعstring
پیش‌فرضwheel
دستور متنی برای هدایت قطعه‌بندی.
point_promptsاختیاری
نوعobject[]
پیش‌فرض[]
مجموعه‌ای از پرامپت‌های مبتنی بر نقطه.
point_prompts[].xاختیاری
نوعinteger | null
موقعیت پرامپت روی محور X.
point_prompts[].yاختیاری
نوعinteger | null
موقعیت پرامپت روی محور Y.
point_prompts[].labelاختیاری
نوعenum
01
برچسب پیش‌زمینه/پس‌زمینه: مقدار 1 نشان‌دهنده پیش‌زمینه و 0 نشان‌دهنده پس‌زمینه است.
point_prompts[].object_idاختیاری
نوعinteger | null
شناسه اختیاری برای گروه‌بندی پرامپت‌هایی که یک شیء را اصلاح می‌کنند. اگر متن نیز به‌عنوان پرامپت ارائه شود، این شناسه تعیین می‌کند نقاط کدام شیء شناسایی‌شده را اصلاح کنند.
point_prompts[].frame_indexاختیاری
نوعinteger | null
شاخص شناسایی‌کننده فریم برای تعامل.
box_promptsاختیاری
نوعobject[]
پیش‌فرض[]
پرامپت‌های جعبه‌ای که object_id آن‌ها گروه‌بندی را تعیین می‌کند: شناسه‌های یکسان جعبه‌ها را به یک شیء مرتبط می‌کنند و شناسه‌های خالی نشان‌دهنده اشیای جداگانه‌اند. چند جعبه را می‌توان با مختصات (x_min, y_min, x_max, y_max) ارائه کرد.
box_prompts[].x_minاختیاری
نوعinteger | null
کمینهٔ مختصات x برای کادر.
box_prompts[].y_minاختیاری
نوعinteger | null
کمینهٔ مختصات y برای کادر.
box_prompts[].x_maxاختیاری
نوعinteger | null
حداکثر مختصات X برای جعبه.
box_prompts[].y_maxاختیاری
نوعinteger | null
حداکثر مختصات Y برای جعبه.
box_prompts[].object_idاختیاری
نوعinteger | null
شناسه اختیاری برای گروه‌بندی جعبه‌هایی که یک شیء را اصلاح می‌کنند.
box_prompts[].frame_indexاختیاری
نوعinteger | null
شاخص شناسایی‌کننده فریم برای تعامل.
apply_maskاختیاری
نوعboolean
پیش‌فرضtrue
کنترل می‌کند که ماسک روی تصویر اعمال شود یا نه.
output_formatاختیاری
نوعenum
پیش‌فرضpng
jpegpngwebp
قالب فایل تصویر نهایی.
return_multiple_masksاختیاری
نوعboolean
پیش‌فرضfalse
گزینه بازگرداندن چند ماسک: با فعال‌کردن آن، `max_masks` تعداد ماسک‌های تولیدشده برای بارگذاری و گنجاندن در پاسخ را تعیین می‌کند.
max_masksاختیاری
نوعinteger
پیش‌فرض3
۱ – ۳۲
حد بالای ماسک‌های بازگردانده‌شده هنگام فعال‌بودن `return_multiple_masks`.
include_scoresاختیاری
نوعboolean
پیش‌فرضfalse
گنجاندن امتیازهای اطمینان برای ماسک‌ها را کنترل می‌کند.
include_boxesاختیاری
نوعboolean
پیش‌فرضfalse
گنجاندن کادر محدودکننده برای هر ماسک را در صورت وجود کنترل می‌کند.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3-1/image-rle",
  "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": 10,
    "usd": "0.01",
    "charged": 10,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "rle": "string",
    "boundingbox_frames_zip": {
      "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
    },
    "metadata": [
      {
        "index": 1,
        "score": 1.0,
        "box": [
          1.0
        ]
      }
    ],
    "scores": [
      1.0
    ],
    "boxes": [
      [
        1.0
      ]
    ]
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "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 شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
rle
string | array of stringماسک با استفاده از کدگذاری طول اجرا.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullبایگانی ZIP پوشش‌های کادر محدودکننده برای هر فریم.
metadata
array of object {index, score, box} | nullفرادادهٔ هر ماسک که هنگام وجود چند RLE در پاسخ گنجانده می‌شود.
scores
array of number | nullامتیاز اطمینان هر ماسک که در صورت درخواست ارائه می‌شود.
boxes
array of array of number | nullکادرهای نرمال‌شدهٔ هر ماسک، به‌صورت [cx, cy, w, h] در صورت درخواست.

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

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