שפּרינגען צו אינהאַלט

BiRefNet V2 Background Removal

אינטעגרירן

מאָדעל־id 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"

לויפֿן דעם ריקוועסט

אײַער 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` בייפּאַסט פֿאָרגרונט־פֿאַרבעסערונג און לאָזט דאָס בילד אומבאַהאַנדלט, צוריקקערן בלויז זײַן סעגמענטאַציע־מאַסקע. ווען מען דאַרף נאָר אַ מאַסקע, פֿאַרמײַדט דאָס עקסטרע רעכענונג און פֿאַרקלענערט די איבערגעטראָגענע דאַטן.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 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/yi/developers/models/birefnet/v2.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt