דילוג לתוכן

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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

בקשה זו: ≈⁨‏0.003 ‏$⁩ 3 קרדיטי API · ≈ ⁨‏0.32 ‏₽⁩ הרצה בדף הזה

קבלת מפתח API
Moondream עריכת תמונה קלטים מסוג רפרנס #mask#segmentation

פילוח אובייקט בעל שם בתמונה והחזרת מסכה, תיבת תחימה ונתיב SVG

Moondream · תמונה

התוצאה הראשונה שלך תופיע כאן

בנו בקשה למטה והריצו אותה עם מפתח ה־API שלכם. הפלטים מועתקים לאחסון שלנו ונשמרים לצמיתות או למשך 7 ימים ללא תשלום.

בנה בקשה

הפקדים נוצרים מסכמת המודל. הקוד והמחיר מתעדכנים כשמשנים אותם.

•חובה 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 הצעת מחיר → ⁨‏0.003 ‏$⁩
# 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/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.ru/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
0 – 1
טמפרטורת הדגימה קובעת את האיזון בין פלט ממוקד ודטרמיניסטי בהגדרות נמוכות לבין אקראיות רבה יותר בהגדרות גבוהות.
settings.top_pאופציונלי
סוגnumber
ברירת מחדל1
0 – 1
מסת ההסתברות לדגימת nucleus, בטווח שבין 0 ל־1.
settings.max_tokensאופציונלי
סוגinteger | null
≥ 1
גבול עליון למספר הטוקנים שנוצרו.
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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
הקבצים שלכם, הבחירה שלכםכל outputs[].url הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?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.

מודלים נוספים: עריכת תמונה

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/moondream3-preview/segment.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt