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

Birefnet Background Removal

אינטעגרירן

מאָדעל־id birefnet
# 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?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.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 אַראָפּנעמען הינטערגרונט #background-removal#segmentation#high-res#utility

נעמט אַראָפּ דעם הינטערגרונט פֿון איין בילד, מיט לײַכט, שווער אָדער פּאָרטרעט־וועריאַנטן און אָפּציאָנעלער מאַסקע־אויסגאַבע

BiRefNet · בילד

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

•פארלאנגט image_url
לייגט אַרײַן אַ טעקע, אָדער

URL וואָס אידענטיפֿיצירט דעם בילד וועמענס הינטערגרונט וועט ווערן אַוועקגענומען.

פֿאָרגעשריטן operating_resolution · output_format · model · output_mask · refine_foreground
operating_resolution סטאַנדאַרט 1024x1024

פּראַסעסיר־רעזאָלוציע קאָנטראָלירט די אַקיעראַטקייט אויף קוואַליטעט־הויכע מקור־בילדער; אַ גרעסערע רעזאָלוציע פֿאַרבעסערט די אַקיעראַטקייט.

output_format סטאַנדאַרט png

פֿאָרמאַט פֿונעם רעזולטירנדיקן בילד.

סטאַנדאַרט General Use (Light)

אויסקלײַב פֿונעם הינטערגרונט־אוועקנעמונג־מאָדעל: 'General Use (Light)' קאָרעספּאָנדירט צו BiRefNet-DIS_ep580.pth, איז דער אָריגינעלער מאָדעל פֿונעם BiRefNet רעפּאַזאַטאָרי און ווערט רעקאָמענדירט פֿאַר רובֿ באַניץ. 'General Use (Heavy)' קאָרעספּאָנדירט צו BiRefNet-massive-epoch_240.pth און אָפפערט גרעסערע אַקיעראַטקייט מיט פּאַמעלעכערע פּראַסעסירונג. 'Portrait' קאָרעספּאָנדירט צו BiRefNet-portrait-TR_P3M_10k-epoch_120.pth און איז ספּעציפֿיש אויסגעלערנט אויף פּאָרטרעט־בילדער.

POST /run/birefnet?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?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.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 Background Removal

סעגמענטירט דעם פֿאָרגרונט פֿון איין בילד געגעבן דורך `image_url` און גיט עס צוריק מיט אַוועקגענומענעם הינטערגרונט. די `model` אָפּציע אָפפערט General Use (Light), General Use (Heavy) אָדער Portrait. `operating_resolution` קען זײַן 1024x1024 אָדער 2048x2048 פֿאַר העכער־רעזאָלוציע אַרײַנגעבונגען. מע קען אויך צוריקגעבן די מאַסקע מיט `output_mask` און אויסקלײַבן png, webp אָדער gif.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
modelאָפּציאָנעל
טיפּenum
סטאַנדאַרטGeneral Use (Light)
General Use (Light)General Use (Heavy)Portrait
אויסקלײַב פֿונעם הינטערגרונט־אוועקנעמונג־מאָדעל: 'General Use (Light)' קאָרעספּאָנדירט צו BiRefNet-DIS_ep580.pth, איז דער אָריגינעלער מאָדעל פֿונעם BiRefNet רעפּאַזאַטאָרי און ווערט רעקאָמענדירט פֿאַר רובֿ באַניץ. 'General Use (Heavy)' קאָרעספּאָנדירט צו BiRefNet-massive-epoch_240.pth און אָפפערט גרעסערע אַקיעראַטקייט מיט פּאַמעלעכערע פּראַסעסירונג. 'Portrait' קאָרעספּאָנדירט צו BiRefNet-portrait-TR_P3M_10k-epoch_120.pth און איז ספּעציפֿיש אויסגעלערנט אויף פּאָרטרעט־בילדער.
operating_resolutionאָפּציאָנעל
טיפּenum
סטאַנדאַרט1024x1024
1024x10242048x2048
פּראַסעסיר־רעזאָלוציע קאָנטראָלירט די אַקיעראַטקייט אויף קוואַליטעט־הויכע מקור־בילדער; אַ גרעסערע רעזאָלוציע פֿאַרבעסערט די אַקיעראַטקייט.
output_maskאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
קאָנטראָלירט צי דער הינטערגרונט־אוועקנעמונג־מאַסקע ווערט אַרײַנגענומען אין רעזולטאַט.
refine_foregroundאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קאָנטראָלירט פֿאָרגרונט־פֿאַרבעסערונג באזירט אויף דער געשאַצטער מאַסקע.
image_urlפארלאנגט image
טיפּurl · image
URL וואָס אידענטיפֿיצירט דעם בילד וועמענס הינטערגרונט וועט ווערן אַוועקגענומען.
output_formatאָפּציאָנעל
טיפּenum
סטאַנדאַרטpng
webppnggif
פֿאָרמאַט פֿונעם רעזולטירנדיקן בילד.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם file_url פֿון אַן אַרויפֿלאָד. טעקעס

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "birefnet",
  "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_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.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_image
object {url, content_type, file_name, file_size, width, height} | nullמאַסקע געווענדט בעת הינטערגרונט־אוועקנעמונג.

מער מאָדעלן: אַראָפּנעמען הינטערגרונט

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/birefnet.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt