رفتن به محتوا

EVF-SAM2 Segmentation

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

شناسه مدل evf-sam
# 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/evf-sam?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

این درخواست: ⁨‎$۰٫۰۰۵⁩ ۵ اعتبار API · ≈ ⁨‎₽۰٫۵۳⁩ اجرای آن در این صفحه

دریافت کلید API
Open model ویرایش تصویر #segmentation#mask

بخش‌بندی تصویر با راهنمایی متن و برگرداندن ماسک‌ها از promptهای مثبت و منفی

Open model · تصویر

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

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

ساخت درخواست

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

•الزامی

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

ناحیه‌هایی که با کسر آن‌ها از نتایج پرامپت، از قطعه‌بندی حذف می‌شوند.

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

URL تصویر ورودی.

پیشرفته blur_mask · expand_mask · semantic_type · mask_only · use_grounding_dino · revert_mask · fill_holes
پیش‌فرض 0

اندازه هسته تاری Gaussian برای ماسک؛ مقدار باید فرد باشد.

پیش‌فرض 0

ماسک را به تعداد پیکسل مشخص‌شده به سمت بیرون گسترش می‌دهد.

POST /run/evf-sam?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/evf-sam?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

درباره EVF-SAM2 Segmentation

ناحیه‌های تصویر توصیف‌شده با `prompt` را بخش‌بندی می‌کند و `negative_prompt` ناحیه‌ها را حذف می‌کند. گزینه‌ها شامل `semantic_type`، `use_grounding_dino`، `revert_mask`، `fill_holes`، `blur_mask` (از 0 تا 50) و `expand_mask` (از 0 تا 20) هستند. مقدار پیش‌فرض `mask_only` برابر true است و به‌جای تصویر ماسک‌شده، ماسک دودویی برمی‌گرداند.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
پرامپت مورد استفاده برای تولید قطعه‌بندی.
negative_promptاختیاری
نوعstring | null
ناحیه‌هایی که با کسر آن‌ها از نتایج پرامپت، از قطعه‌بندی حذف می‌شوند.
semantic_typeاختیاری
نوعboolean
پیش‌فرضfalse
قطعه‌بندی معنایی بخش‌های بدن، پس‌زمینه‌ها یا چند شیء را فعال می‌کند.
image_urlالزامی image
نوعurl · image
URL تصویر ورودی.
mask_onlyاختیاری
نوعboolean
پیش‌فرضtrue
فقط ماسک دودویی را به‌جای تصویر ماسک‌شده برمی‌گرداند.
use_grounding_dinoاختیاری
نوعboolean
پیش‌فرضfalse
قطعه‌بندی به‌جای SAM از GroundingDINO استفاده می‌کند.
revert_maskاختیاری
نوعboolean
پیش‌فرضfalse
ماسک را معکوس می‌کند و پیش‌زمینه و پس‌زمینه را جابه‌جا می‌کند.
blur_maskاختیاری
نوعinteger
پیش‌فرض0
۰ – ۵۰
اندازه هسته تاری Gaussian برای ماسک؛ مقدار باید فرد باشد.
expand_maskاختیاری
نوعinteger
پیش‌فرض0
۰ – ۲۰
ماسک را به تعداد پیکسل مشخص‌شده به سمت بیرون گسترش می‌دهد.
fill_holesاختیاری
نوعboolean
پیش‌فرضfalse
برای پرکردن حفره‌های ماسک از عملیات ریخت‌شناختی استفاده می‌کند.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "evf-sam",
  "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": 5,
    "usd": "0.005",
    "charged": 5,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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
    }
  },
  "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.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 شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
image
object {url, content_type, file_name, file_size}تصویر تولیدشده از قطعه‌بندی.

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