דילוג לתוכן

Sam 3 1 · Image

שילוב

מזהה מודל sam-3-1/image
# 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/sam-3-1/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

בקשה זו: ≈⁨‏0.01 ‏$⁩ 10 קרדיטי API · ≈ ⁨‏1.05 ‏₽⁩ הרצה בדף הזה

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

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

Meta · תמונה

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

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

בנה בקשה

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

ברירת מחדל 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?wait=20 הצעת מחיר → ⁨‏0.01 ‏$⁩
# 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/sam-3-1/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

הרצת הבקשה הזו

המפתח שלך נשאר בדפדפן הזה: הוא נשלח רק אל Doitong API ונשמר ב-localStorage רק אם מסמנים זכור. קבל מפתח API

מידע על Sam 3 1 · Image

מסגמנט תמונה אחת באמצעות SAM 3.1 בעזרת `prompt` טקסטואלי, `point_prompts` או `box_prompts`. ניתן לקבץ כמה תיבות לאובייקט באמצעות object_id. `return_multiple_masks` מחזיר עד `max_masks` מסכות (1 עד 32), עם ציונים ותיבות תוחמות אופציונליים. פורמט הפלט הוא jpeg, png או webp.

פרמטרים

שלח את השם הקנוני או את השם המקומי, לא את שניהם. שמות קנוניים

שםסוג ברירת מחדלמותר תיאור
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
1 – 32
הגבול העליון למספר המסכות המוחזרות כאשר `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",
  "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": {
    "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
    },
    "masks": [
      {
        "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
      }
    ],
    "metadata": [
      {
        "index": 1,
        "score": 1.0,
        "box": [
          1.0
        ]
      }
    ],
    "scores": [
      1.0
    ],
    "boxes": [
      [
        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 הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
image
object {url, content_type, file_name, file_size, width, height} | nullתצוגה מקדימה המציגה את מסכת הסגמנטציה הראשית.
masks
array of object {url, content_type, file_name, file_size, width, height}תמונות המכילות מסכות סגמנטציה.
metadata
array of object {index, score, box} | nullמטא-נתונים עבור כל מסכה, כולל הציון והתיבה שלה.
scores
array of number | nullציון הביטחון עבור כל מסכה, מסופק כאשר הוא מתבקש.
boxes
array of array of number | nullתיבות מנורמלות עבור כל מסכה, המובעות כ-[cx, cy, w, h], אם התבקשו.

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

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