דילוג לתוכן

Birefnet

שילוב

מזהה מודל birefnet/v2/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/birefnet/v2/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"

עד ⁨‏2.07 ‏$⁩ להרצה החיוב מתבצע לפי השימוש בפועל, והיתרה מוחזרת הרצה בדף הזה

קבלת מפתח API
BiRefNet הסרת רקע #utility#editing

מסיר רקעים מסרטונים, עם שש אפשרויות מודל, מטינג ופלט mp4, webm, mov או gif

BiRefNet · ווידאו

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

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

בנה בקשה

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

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

כתובת URL המזהה את הווידאו שהרקע שלו יוסר.

מתקדם operating_resolution · video_output_type · video_quality · video_write_mode · model · output_mask · refine_foreground
operating_resolution ברירת מחדל 1024x1024

רזולוציית העבודה, כאשר '2304x2304' מוגבלת למודל 'General Use (Dynamic)'. עבור תמונות קלט ברזולוציה גבוהה, הגדרות גבוהות יותר משפרות את דיוק הפלט.

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

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

video_quality ברירת מחדל high

רמת האיכות של הווידאו המתקבל.

video_write_mode ברירת מחדל balanced

מצב הכתיבה של הווידאו המתקבל.

ברירת מחדל General Use (Light)

בחירת מודל להסרת רקע: 'General Use (Light)' ממופה ל־BiRefNet, המודל המקורי של מאגר BiRefNet ומומלץ לרוב השימושים. 'General Use (Light 2K)' ממופה ל־BiRefNet_lite-2K ומשתמש במודל המקורי שאומן על תמונות 2K. 'General Use (Heavy)' ממופה ל־BiRefNet_lite ומספק דיוק רב יותר בעיבוד איטי יותר. 'Matting' ממופה ל־BiRefNet-matting ואומן במיוחד לגזירת תמונות. 'Portrait' ממופה ל־BiRefNet-portrait ואומן במיוחד על תמונות דיוקן. 'General Use (Dynamic)' ממופה ל־BiRefNet_dynamic ותומך ברזולוציות משתנות מ־256x256 עד 2304x2304.

POST /run/birefnet/v2/video?wait=20 הצעת מחיר → ⁨‏2.07 ‏$⁩
# 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/birefnet/v2/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

מידע על Birefnet

מיישם סגמנטציה של BiRefNet על כל פריים בסרטון מ־`video_url`. המודלים כוללים Light, Light 2K, Heavy, Matting, Portrait ו־Dynamic, ברזולוציות עיבוד של עד 2304x2304 (רק למודל Dynamic). הפלט יכול להיות X264 mp4, VP9 webm, ProRes 4444 mov או GIF, עם הגדרות `video_quality` ו־`video_write_mode`. ניתן לבקש סרטון מסכה נפרד.

פרמטרים

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

שםסוג ברירת מחדלמותר תיאור
modelאופציונלי
סוגenum
ברירת מחדלGeneral Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
בחירת מודל להסרת רקע: 'General Use (Light)' ממופה ל־BiRefNet, המודל המקורי של מאגר BiRefNet ומומלץ לרוב השימושים. 'General Use (Light 2K)' ממופה ל־BiRefNet_lite-2K ומשתמש במודל המקורי שאומן על תמונות 2K. 'General Use (Heavy)' ממופה ל־BiRefNet_lite ומספק דיוק רב יותר בעיבוד איטי יותר. 'Matting' ממופה ל־BiRefNet-matting ואומן במיוחד לגזירת תמונות. 'Portrait' ממופה ל־BiRefNet-portrait ואומן במיוחד על תמונות דיוקן. 'General Use (Dynamic)' ממופה ל־BiRefNet_dynamic ותומך ברזולוציות משתנות מ־256x256 עד 2304x2304.
operating_resolutionאופציונלי
סוגenum
ברירת מחדל1024x1024
1024x10242048x20482304x2304
רזולוציית העבודה, כאשר '2304x2304' מוגבלת למודל 'General Use (Dynamic)'. עבור תמונות קלט ברזולוציה גבוהה, הגדרות גבוהות יותר משפרות את דיוק הפלט.
output_maskאופציונלי
סוגboolean
ברירת מחדלfalse
קובע אם מסכת הסרת הרקע תיכלל בפלט.
refine_foregroundאופציונלי
סוגboolean
ברירת מחדלtrue
קובע את עידון החזית על סמך המסכה המשוערת.
video_urlחובה video
סוגurl · video
כתובת URL המזהה את הווידאו שהרקע שלו יוסר.
video_output_typeאופציונלי
סוגenum
ברירת מחדלX264 (.mp4)
X264 (.mp4)VP9 (.webm)PRORES4444 (.mov)GIF (.gif)
סוג הפלט של הווידאו המתקבל.
video_qualityאופציונלי
סוגenum
ברירת מחדלhigh
lowmediumhighmaximum
רמת האיכות של הווידאו המתקבל.
video_write_modeאופציונלי
סוגenum
ברירת מחדלbalanced
fastbalancedsmall
מצב הכתיבה של הווידאו המתקבל.
חובה שם קנוני, מתקבל גם הוא

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

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "birefnet/v2/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": 2070,
    "usd": "2.07",
    "charged": 2070,
    "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,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    },
    "mask_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,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    }
  },
  "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, width, height, fps, duration, num_frames}וידאו לאחר הסרת הרקע.
mask_video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames} | nullמסכה שהוחלה במהלך הסרת הרקע.

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