דילוג לתוכן

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"

בקשה זו: ≈⁨‏0.002 ‏$⁩ 2 קרדיטי API הרצה בדף הזה

קבלת מפתח API
Meta עריכת תמונה #segmentation#mask#real-time

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

Meta · תמונה

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

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

בנה בקשה

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

•חובה image_url
גרור קובץ, או

כתובת URL המצביעה על התמונה לסגמנטציה.

מתקדם output_format · apply_mask · prompts · box_prompts
output_format ברירת מחדל png

פורמט הקובץ של התמונה שהתקבלה.

ברירת מחדל []

הנחיות המשמשות לפילוח תמונה.

ברירת מחדל []

קואורדינטות גבולות התיבה.

POST /run/sam2/image?wait=20 הצעת מחיר → ⁨‏0.002 ‏$⁩
# 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-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
image
object {url, content_type, file_name, file_size, width, height}תמונה שעליה הוחל פילוח.

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

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