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

Void Video Inpainting

אינטעגרירן

מאָדעל־id void-video-inpainting
# 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/void-video-inpainting?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",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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.10⁩ 100 API־קרעדיטן אײַערע פֿײַלן ווערן געמאסטן איידערן לויפֿן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Open model ווידעא צו ווידעא #utility#editing

נעמט אַראָפּ אַן אַבדזשעקט פֿון אַ ווידעא צוזאַמען מיט זײַנע עפעקטן אויף דער סצענע, ניצנדיק אַ מאַסקע־ווידעא אָדער טעקסט־מאַסקע־פּראָמפּט

Open model · ווידעא

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

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

בויען אַ בעטן

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

•פארלאנגט

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

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

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

סטאַנדאַרט
לייגט אַרײַן אַ טעקע, אָדער

URL פֿון אַ ווידעא מיט דער באַזייַטיקונג־מאַסקע; אויב עס פֿעלט, שאַפֿט די אַפּ אַ צײַטווײַליקע ווידעא־מאַסקע דורך דעם SAM-3 ווידעא־ענדפּוינט מיט `mask_prompt`, און פֿאַרוואַנדלט זי אויטאָמאַטיש אין אַ קוואַדמאַסקע. פֿאַר בעסטע רעזולטאַטן צושטעלט אַ VOID־סטיל קוואַדמאַסקע מיט 4 גרייסקײַל־ווערטלעך: 255 פֿאַר געהאַלטענעם הינטערגרונט, 127 פֿאַר דער באַווירקטער געגנט, 63 פֿאַר איבערלאַפּ און 0 פֿאַר דעם אָביעקט וואָס ווערט באַזייטיקט. ביינערי מאַסקעס ווערן אויך אָנגענומען, מיט 255 צו האַלטן און 0 צו באַזייטיקן.

פֿאָרגעשריטן mask_prompt · negative_prompt · num_inference_steps · guidance_scale · strength · num_frames · seed · enable_safety_checker

אינסטרוקציעס פֿאַר SAM-3 צו שאַפֿן אַ צײַטווײַליקע מאַסקע־ווידעא ווען קיין `quad_mask_video_url` ווערט נישט צוגעשטעלט. אידענטיפֿיצירט וואָס צו מאַסקירן, למשל אַן אָביעקט אָדער מענטש וואָס זאָל אַראָפּגענומען ווערן פֿונעם מקור־ווידעא.

סטאַנדאַרט The video is not of a...

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

סטאַנדאַרט 30

צאָל דענאָיִזינג־טריט. דאָס העכערן פֿאַרבעסערט קוואַליטעט, אָבער לייגט צו לאַטענץ.

סטאַנדאַרט 1

שטאַרקייט פֿון classifier-free guidance.

סטאַנדאַרט 1

שטאַרקייט פֿון דענאָיִזינג, וווּ 1.0 מיינט גאַנץ דענאָיִזינג.

סטאַנדאַרט 85

געבעטן צײַטלעכן אינפֿערענץ־פֿענצטער, צוגעפּאַסט דורכן באַקענד צו איינעם פֿון די CogVideoX־זיכערע גרייסן 69, 77, 85, ..., 197. דער נאָענטסטער אַזאַ גרייס ווערט אויסגעקליבן צו אַקאָמאָדירן צײַטלעכע קאָמפּרעסיע און פּאַטשינג.

סיד וואָס קאָנטראָלירט צופאַל פֿאַר רעפּראָדוצירבאַרע רעזולטאַטן.

POST /run/void-video-inpainting?wait=20 פּרײַז → ⁨$ 0.10⁩
# 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/void-video-inpainting?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",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 שליסל

וועגן Void Video Inpainting

נעמט `video_url` און אַ `prompt` וואָס באַשרייבט דעם געווינטשענעם הינטערגרונט. שטעלט צו אַ `quad_mask_video_url`, אָדער גיט אַ `mask_prompt` כּדי צו גענערירן אַ מאַסקע. קאָנטראָלס רעכענען אַריין `num_frames` (1-197), `num_inference_steps` (1-50), `guidance_scale`, `strength` און אַן אָפּציאָנעלע פּאַמעלעכערע `enable_pass2_refinement` פֿאַר צייטווייליקע קאָנסיסטענץ.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
video_urlפארלאנגט video
טיפּurl · video
מקור־ווידעא־URL וואָס אַנטהאַלט דעם אָביעקט פֿאַר באַזייַטיקונג.
quad_mask_video_urlאָפּציאָנעל
טיפּurl · video
סטאַנדאַרט
URL פֿון אַ ווידעא מיט דער באַזייַטיקונג־מאַסקע; אויב עס פֿעלט, שאַפֿט די אַפּ אַ צײַטווײַליקע ווידעא־מאַסקע דורך דעם SAM-3 ווידעא־ענדפּוינט מיט `mask_prompt`, און פֿאַרוואַנדלט זי אויטאָמאַטיש אין אַ קוואַדמאַסקע. פֿאַר בעסטע רעזולטאַטן צושטעלט אַ VOID־סטיל קוואַדמאַסקע מיט 4 גרייסקײַל־ווערטלעך: 255 פֿאַר געהאַלטענעם הינטערגרונט, 127 פֿאַר דער באַווירקטער געגנט, 63 פֿאַר איבערלאַפּ און 0 פֿאַר דעם אָביעקט וואָס ווערט באַזייטיקט. ביינערי מאַסקעס ווערן אויך אָנגענומען, מיט 255 צו האַלטן און 0 צו באַזייטיקן.
mask_promptאָפּציאָנעל
טיפּstring | null
אינסטרוקציעס פֿאַר SAM-3 צו שאַפֿן אַ צײַטווײַליקע מאַסקע־ווידעא ווען קיין `quad_mask_video_url` ווערט נישט צוגעשטעלט. אידענטיפֿיצירט וואָס צו מאַסקירן, למשל אַן אָביעקט אָדער מענטש וואָס זאָל אַראָפּגענומען ווערן פֿונעם מקור־ווידעא.
promptפארלאנגט
טיפּstring
באַשרײַבונג וואָס ספּעציפֿיצירט ווי דער הינטערגרונט זאָל אויסזען נאָך דעם ווי דער אָביעקט ווערט באַזייטיקט.
enable_pass2_refinementאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
אָפּציאָנאַלע VOID פֿאַרבעסערונג וואָס וועקסלט לענגערע פּראַסעסירונג קעגן מעגלעך בעסערע צײַטלעכע קאָנסיסטענץ אין לענגערע קליפּס. זי אַפּליקירט פֿאַרקרומטע ראַש־פֿאַרבעסערונג ווי Pass 2 נאָך Pass 1.
negative_promptאָפּציאָנעל
טיפּstring
סטאַנדאַרטThe video is not of a high quality, it has a low resolution. Watermark present in each frame. The background is solid. Strange body and strange trajectory. Distortion.
נעגאַטיווער פּראָמפּט וואָס באַשרײַבט נישט־געוווּנטשענע רעזולטאַטן, כּדי די גענערירונג זאָל זיך דערווײַטערן פֿון זיי.
num_inference_stepsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט30
1 – 50
צאָל דענאָיִזינג־טריט. דאָס העכערן פֿאַרבעסערט קוואַליטעט, אָבער לייגט צו לאַטענץ.
guidance_scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט1
0 – 20
שטאַרקייט פֿון classifier-free guidance.
strengthאָפּציאָנעל
טיפּnumber
סטאַנדאַרט1
0 – 1
שטאַרקייט פֿון דענאָיִזינג, וווּ 1.0 מיינט גאַנץ דענאָיִזינג.
seedאָפּציאָנעל
טיפּinteger | null
סיד וואָס קאָנטראָלירט צופאַל פֿאַר רעפּראָדוצירבאַרע רעזולטאַטן.
num_framesאָפּציאָנעל
טיפּinteger
סטאַנדאַרט85
1 – 197
געבעטן צײַטלעכן אינפֿערענץ־פֿענצטער, צוגעפּאַסט דורכן באַקענד צו איינעם פֿון די CogVideoX־זיכערע גרייסן 69, 77, 85, ..., 197. דער נאָענטסטער אַזאַ גרייס ווערט אויסגעקליבן צו אַקאָמאָדירן צײַטלעכע קאָמפּרעסיע און פּאַטשינג.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
אַקטיוויזירט זיכערהייט־קאָנטראָלן פֿאַר גענערירטן אינהאַלט.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "void-video-inpainting",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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
    },
    "seed": 42,
    "timings": {}
  },
  "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}רעזולטאַט־ווידעא נאָך באַזייַטיקן דעם אָביעקט.
seed
integerסיד־ווערט וואָס ווערט געווענדט בעת גענערירונג.
timings
objectצײַט־דעטאַלן פֿאַר יעדער בינע פֿונעם פּייפּליין.

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