דילוג לתוכן

Sam 3 · Video RLE

שילוב

מזהה מודל sam-3/video-rle
# 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-rle?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#rle

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

Meta · ווידאו

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

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

בנה בקשה

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

ברירת מחדל

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

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

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

מתקדם mask · detection_threshold · frame_index · apply_mask · boundingbox_zip · point_prompts · box_prompts
mask_url
גרור קובץ, או

כתובת URL של מסכה עבור היישום הראשוני.

ברירת מחדל 0.5

סף הביטחון לזיהוי, עם ברירת מחדל של 0.5 עבור אובייקטים קיימים ו-0.7 עבור חדשים. בטווח 0.0–1.0, ערכים נמוכים יותר מפחיתים את הדיוק לטובת יותר זיהויים; נסו 0.2–0.3 כאשר הנחיות טקסטואליות נכשלות.

ברירת מחדל 0

אינדקס הפריים לאינטראקציה הראשונית בעת אספקת mask_url.

ברירת מחדל []

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

ברירת מחדל []

רשימת הנחיות תיבה, עם frame_index אופציונלי עבור כל רשומה.

POST /run/sam-3/video-rle?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-rle?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 RLE

מפצל וידאו למקטעים באמצעות SAM 3, עם `prompt` טקסטואלי, הנחיות נקודה או תיבה, או מסכה ראשונית מ-`mask_url` המוחלת ב-`frame_index`. `detection_threshold` נע בין 0.01 ל-1, וערכים נמוכים יותר כמו 0.2 עד 0.3 עשויים לעזור כאשר הנחיות טקסט נכשלות. ניתן להחזיר קובץ zip של תיבות תוחמות לכל פריים באמצעות `boundingbox_zip`.

פרמטרים

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

שםסוג ברירת מחדלמותר תיאור
video_urlחובה video
סוגurl · video
כתובת URL של וידאו לפילוח.
mask_urlאופציונלי mask
סוגurl · image
כתובת 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
מזהה אופציונלי המקבץ הנחיות המעדנות אובייקט יחיד. אם מסופק גם טקסט כהנחיה, מזהה זה קובע איזה אובייקט שזוהה הנקודות מעדנות.
point_prompts[].frame_indexאופציונלי
סוגinteger | null
אינדקס המזהה את הפריים לאינטראקציה.
box_promptsאופציונלי
סוגobject[]
ברירת מחדל[]
רשימת הנחיות תיבה, עם frame_index אופציונלי עבור כל רשומה.
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
ברירת מחדלfalse
האם להחיל מסכה על הווידאו.
boundingbox_zipאופציונלי
סוגboolean
ברירת מחדלfalse
האם להחזיר ארכיון ZIP המכיל שכבות של תיבות תיחום עבור כל פריים.
detection_thresholdאופציונלי
סוגnumber
ברירת מחדל0.5
0.01 – 1
סף הביטחון לזיהוי, עם ברירת מחדל של 0.5 עבור אובייקטים קיימים ו-0.7 עבור חדשים. בטווח 0.0–1.0, ערכים נמוכים יותר מפחיתים את הדיוק לטובת יותר זיהויים; נסו 0.2–0.3 כאשר הנחיות טקסטואליות נכשלות.
frame_indexאופציונלי
סוגinteger
ברירת מחדל0
אינדקס הפריים לאינטראקציה הראשונית בעת אספקת mask_url.
חובה שם קנוני, מתקבל גם הוא

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

פלט

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