رفتن به محتوا

Moondream3 Preview [Segment]

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

شناسه مدل moondream3-preview/segment
# 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/moondream3-preview/segment?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",
    "object": "fox"
  }'

# 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
Moondream ویرایش تصویر ورودی‌های مرجع #mask#segmentation

قطعه‌بندی شیء نام‌برده در تصویر و بازگرداندن ماسک، کادر مرزی و مسیر SVG

Moondream · تصویر

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

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

ساخت درخواست

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

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

URL اشاره‌کننده به تصویر برای پردازش.

•الزامی

شیء هدف برای قطعه‌بندی در تصویر.

پیشرفته preview · spatial_references · settings

راهنمایی مکانی برای قطعه‌بندی، که به‌صورت فهرستی از اشیای Point با اعضای x و y، یا فهرستی از آرایه‌های مختصات ارائه می‌شود. هر آرایه باید شامل 2 عدد اعشاری (x,y) یا 4 عدد اعشاری (x1,y1,x2,y2) باشد.

تنظیمات مدل قطعه‌بندی که نمونه‌برداری را کنترل می‌کنند.

POST /run/moondream3-preview/segment?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/moondream3-preview/segment?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",
    "object": "fox"
  }'

# 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

درباره Moondream3 Preview [Segment]

شیء موجود در `object` را در تصویر واقع در `image_url` قطعه‌بندی می‌کند. نتیجه می‌تواند شامل تصویر ماسک، کادر مرزی و داده مسیر SVG باشد؛ اگر چیزی تشخیص داده نشود، این موارد null هستند. `spatial_references` می‌تواند نقاطی برای هدایت قطعه‌بندی ارائه کند و `settings` نمونه‌برداری را تنظیم می‌کند. برای دریافت ماسک دودویی، `preview` را فعال کنید.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
image_urlالزامی image
نوعurl · image
URL اشاره‌کننده به تصویر برای پردازش.
objectالزامی
نوعstring
شیء هدف برای قطعه‌بندی در تصویر.
spatial_referencesاختیاری
نوعany[]
راهنمایی مکانی برای قطعه‌بندی، که به‌صورت فهرستی از اشیای Point با اعضای x و y، یا فهرستی از آرایه‌های مختصات ارائه می‌شود. هر آرایه باید شامل 2 عدد اعشاری (x,y) یا 4 عدد اعشاری (x1,y1,x2,y2) باشد.
settingsاختیاری
نوعobject
تنظیمات مدل قطعه‌بندی که نمونه‌برداری را کنترل می‌کنند.
settings.temperatureاختیاری
نوعnumber
پیش‌فرض1
۰ – ۱
دمای نمونه‌برداری تعادل بین خروجی متمرکز و قطعی در مقادیر پایین و تصادفی‌بودن بیشتر در مقادیر بالا را تعیین می‌کند.
settings.top_pاختیاری
نوعnumber
پیش‌فرض1
۰ – ۱
جرم احتمال برای نمونه‌برداری هسته‌ای، از 0 تا 1.
settings.max_tokensاختیاری
نوعinteger | null
≥ ۱
حد بالای توکن‌های تولیدشده.
previewاختیاری
نوعboolean
پیش‌فرضfalse
مشخص می‌کند که ماسک دودویی تصویر همراه با پیش‌نمایش خروجی بازگردانده شود یا نه.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "moondream3-preview/segment",
  "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": 3,
    "usd": "0.003",
    "charged": 3,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "object": "fox"
  },
  "output": {
    "finish_reason": "stop",
    "usage_info": {
      "input_tokens": 1,
      "output_tokens": 1,
      "prefill_time_ms": 1.0,
      "decode_time_ms": 1.0,
      "ttft_ms": 1.0
    },
    "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
    },
    "path": "M.657,.996C.610,.984,.529,.938,.447,.875C.411,.848,.363,.815,.341,.802C.188,.714,.093,.623,.038,.511C.011,.455,.000,.406,.000,.340C.000,.269,.006,.234,.025,.186C.051,.123,.092,.079,.161,.042C.240,-0.000,.355,-0.011,.433,.017C.462,.027,.535,.066,.571,.091C.701,.180,.807,.265,.850,.311C.911,.379,.962,.468,.984,.545C.995,.585,.997,.601,.997,.664C.997,.765,.984,.811,.935,.879C.878,.958,.796,1.001,.705,1.000C.685,.999,.664,.998,.657,.996z",
    "bbox": {
      "x_min": 1.0,
      "y_min": 1.0,
      "x_max": 1.0,
      "y_max": 1.0
    }
  },
  "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 شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
finish_reason
stringدلیل پایان تولید خروجی.
usage_info
object {input_tokens, output_tokens, prefill_time_ms, decode_time_ms, ttft_ms}جزئیات مصرف درخواست.
image
object {url, content_type, file_name, file_size, width, height} | nullنتیجه پیش‌نمایش قطعه‌بندی: اگر درخواست تولید پیش‌نمایش نشده باشد یا تشخیص شیء چیزی نیافته باشد null است؛ در غیر این صورت، تصویری شامل ماسک است.
path
string | nullداده مسیر SVG که هنگام تشخیص ماسک قطعه‌بندی بازگردانده می‌شود؛ در غیر این صورت null.
bbox
object {x_min, y_min, x_max, y_max} | nullکادر محدودکننده بازگردانده‌شده برای شیء تشخیص‌داده‌شده و قطعه‌بندی‌شده؛ در غیر این صورت null.

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

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