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

Birefnet

אינטעגרירן

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

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

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

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

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