דילוג לתוכן

Sam 3 1 · Video

שילוב

מזהה מודל sam-3-1/video
# 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/sam-3-1/video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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.19 ‏$⁩ 190 קרדיטי API הקבצים שלכם נמדדים לפני ההרצה הרצה בדף הזה

קבלת מפתח API
Meta ווידאו לווידאו #segmentation#mask#real-time

סגמנטציית וידאו של SAM 3.1 שעוקבת אחר עד 128 אובייקטים ומפיקה פלט mp4 או webm

Meta · ווידאו

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

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

בנה בקשה

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

ברירת מחדל

הנחיית פילוח התומכת בכמה אובייקטים במעקב באמצעות תיאורים המופרדים בפסיקים, כגון 'person, cloth'.

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

כתובת URL של וידאו לפילוח.

מתקדם video_output_type · detection_threshold · max_num_objects · apply_mask · point_prompts · box_prompts
video_output_type ברירת מחדל X264 (.mp4)

סוג הפלט של הווידאו המתקבל.

ברירת מחדל 0.5

סף הביטחון לזיהוי; הפחתת הערך מגדילה את מספר הזיהויים על חשבון הדיוק. הטווח הוא 0.0–1.0.

ברירת מחדל 16

המספר המרבי של אובייקטים שניתן לעקוב אחריהם בווידאו.

ברירת מחדל []

אוסף הנחיות מבוססות נקודות.

ברירת מחדל []

הנחיות תיבה המופיעות כקבוצות קואורדינטות (x_min, y_min, x_max, y_max).

POST /run/sam-3-1/video?wait=20 הצעת מחיר → ⁨‏0.19 ‏$⁩
# 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/sam-3-1/video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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

מידע על Sam 3 1 · Video

מסגמנט ומעקב אחר אובייקטים בווידאו באמצעות SAM 3.1, מתוך `prompt` טקסטואלי מופרד בפסיקים, נקודות או תיבות. `max_num_objects` קובע כמה אובייקטים לעקוב אחריהם, מ-1 עד 128 (ברירת מחדל 16). `detection_threshold` נע בין 0.1 ל-1. הפלט הוא X264 (.mp4) או VP9 (.webm).

פרמטרים

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

שםסוג ברירת מחדלמותר תיאור
video_urlחובה video
סוגurl · video
כתובת URL של וידאו לפילוח.
promptאופציונלי
סוגstring
ברירת מחדל
הנחיית פילוח התומכת בכמה אובייקטים במעקב באמצעות תיאורים המופרדים בפסיקים, כגון 'person, cloth'.
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
מזהה אופציונלי המקבץ הנחיות המעדנות אובייקט יחיד. אם מסופק גם טקסט כהנחיה, מזהה זה קובע איזה אובייקט שזוהה הנקודות מעדנות.
box_promptsאופציונלי
סוגobject[]
ברירת מחדל[]
הנחיות תיבה המופיעות כקבוצות קואורדינטות (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
מזהה אופציונלי המקבץ תיבות המעדנות אובייקט יחיד.
apply_maskאופציונלי
סוגboolean
ברירת מחדלtrue
האם להחיל מסכה על הווידאו.
video_output_typeאופציונלי
סוגenum
ברירת מחדלX264 (.mp4)
X264 (.mp4)VP9 (.webm)
סוג הפלט של הווידאו המתקבל.
detection_thresholdאופציונלי
סוגnumber
ברירת מחדל0.5
0.1 – 1
סף הביטחון לזיהוי; הפחתת הערך מגדילה את מספר הזיהויים על חשבון הדיוק. הטווח הוא 0.0–1.0.
max_num_objectsאופציונלי
סוגinteger
ברירת מחדל16
1 – 128
המספר המרבי של אובייקטים שניתן לעקוב אחריהם בווידאו.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 10 MB, או את file_url של העלאה. קבצים

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3-1/video",
  "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": 190,
    "usd": "0.19",
    "charged": 190,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "boundingbox_frames_zip": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "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 הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
video
object {url, content_type, file_name, file_size}וידאו שנוצר באמצעות פילוח.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullארכיון ZIP של שכבות תיבות התיחום עבור כל פריים.

מודלים נוספים: ווידאו לווידאו

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