דילוג לתוכן

BiRefNet V2 Background Removal

שילוב

מזהה מודל birefnet/v2
# 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?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
  }'

# 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.002 ‏$⁩ 2 קרדיטי API הרצה בדף הזה

קבלת מפתח API
BiRefNet הסרת רקע #cutout#matting#open-weights

הסרת רקע וחיתוך פתוחים עד 2304 px, עם פלט מסכה אופציונלי.

BiRefNet · תמונה

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

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

בנה בקשה

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

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

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

מתקדם operating_resolution · output_format · model · output_mask · refine_foreground · mask_only
operating_resolution ברירת מחדל 1024x1024

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

output_format ברירת מחדל png

הפורמט של התמונה המתקבלת.

ברירת מחדל 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?wait=20 הצעת מחיר → ⁨‏0.002 ‏$⁩
# 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?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
  }'

# 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 V2 Background Removal

BiRefNet V2 מפריד את הנושא מהרקע באמצעות כמה גרסאות מודל (light, heavy, matting, portrait, dynamic) ורזולוציות עיבוד עד 2304x2304. מחזיר את האובייקט החתוך ובאופן אופציונלי את המסכה ב- PNG, WebP או GIF.

פרמטרים

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

שםסוג ברירת מחדלמותר תיאור
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
קובע את עידון החזית על סמך המסכה המשוערת.
image_urlחובה image
סוגurl · image
כתובת URL המזהה את התמונה שהרקע שלה יוסר.
output_formatאופציונלי
סוגenum
ברירת מחדלpng
webppnggif
הפורמט של התמונה המתקבלת.
mask_onlyאופציונלי
סוגboolean
ברירת מחדלfalse
מתג פלט של המסכה בלבד: `True` עוקף את עידון החזית ומשאיר את התמונה ללא שינוי, תוך החזרת מסכת הסגמנטציה בלבד. כאשר נדרשת מסכה בלבד, הדבר מונע חישוב נוסף ומפחית את כמות הנתונים המועברת.
חובה שם קנוני, מתקבל גם הוא

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

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "birefnet/v2",
  "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": 2,
    "usd": "0.002",
    "charged": 2,
    "refunded": 0
  },
  "input": {
    "image": "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.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
    },
    "mask_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
    }
  },
  "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.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 הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
image
object {url, content_type, file_name, file_size, width, height}תמונה לאחר הסרת הרקע, או מסכת הסגמנטציה כאשר `mask_only` הוא `True`.
mask_image
object {url, content_type, file_name, file_size, width, height} | nullמסכה שהוחלה במהלך הסרת הרקע.

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

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