דילוג לתוכן

Sam 3 · Video

שילוב

מזהה מודל sam-3/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/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.095 ‏$⁩ 95 קרדיטי API הקבצים שלכם נמדדים לפני ההרצה הרצה בדף הזה

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

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

Meta · ווידאו

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

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

בנה בקשה

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

ברירת מחדל

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

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

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

מתקדם text_prompt · video_output_type · detection_threshold · apply_mask · point_prompts · box_prompts

[DEPRECATED] קלט ישן שנשמר לתאימות לאחור; השתמשו ב-'prompt' במקומו.

video_output_type ברירת מחדל X264 (.mp4)

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

ברירת מחדל 0.5

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

ברירת מחדל []

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

ברירת מחדל []

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

POST /run/sam-3/video?wait=20 הצעת מחיר → ⁨‏0.095 ‏$⁩
# 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/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 · Video

מזהה אובייקטים ועוקב אחריהם לאורך וידאו שסופק באמצעות `video_url`. ציינו את האובייקטים ב-`prompt`, כשהפרדה בין כמה אובייקטים נעשית באמצעות פסיקים, או השתמשו ב-`point_prompts` וב-`box_prompts`. `detection_threshold` נע בין 0.1 ל-1, ו-`apply_mask` קובע אם המסכה תצויר על הווידאו. הפלט הוא mp4 או webm, בתוספת קובץ zip של שכבות תיבות תוחמות לכל פריים.

פרמטרים

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

שםסוג ברירת מחדלמותר תיאור
video_urlחובה video
סוגurl · video
כתובת URL של וידאו לפילוח.
promptאופציונלי
סוגstring
ברירת מחדל
הנחיית פילוח התומכת בכמה אובייקטים במעקב באמצעות תיאורים המופרדים בפסיקים, כגון 'person, cloth'.
text_promptאופציונלי
סוגstring | null
[DEPRECATED] קלט ישן שנשמר לתאימות לאחור; השתמשו ב-'prompt' במקומו.
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.
חובה שם קנוני, מתקבל גם הוא

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

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/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": 95,
    "usd": "0.095",
    "charged": 95,
    "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/video.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt