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

ID-V2V

אינטעגרירן

מאָדעל־id id-v2v
# 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/id-v2v?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "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"

פֿײַלן ווי דער בײַשפּיל: ⁨$ 1.013⁩ 1,013 API־קרעדיטן אײַערע פֿײַלן ווערן געמאסטן איידערן לויפֿן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Open model ווידעא צו ווידעא ביז 720p #stylized#transform#editing

ריסטיילט אַ ווידעאָ פֿון אַ ריסטיילטער ערשטער־פֿרעם, בשעת ער האַלט די אידענטיטעט און באַוועגונג פֿונעם סוביעקט

Open model · ווידעא

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

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

בויען אַ בעטן

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

•פארלאנגט

פּראָמפּט וואָס ספּעציפֿיצירט דעם געוווּנטשטן ווידעא נאָך־סטיליזירט.

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

רעפֿערענץ פֿאַר באַוועגונג און קאַדורונג בעת גענערירונג, צוגעשטעלט ווי דער קוואַל־ווידעאָס URL.

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

רעפֿערענץ פֿאַר אידענטיטעט און סטיל בײַ ווידעא־ווידערגענערירונג, צוגעשטעלט ווי אַ URL צו דעם נאָך־סטיליזירטן ערשטן ראַם.

resolution סטאַנדאַרט 720p

קלײַבט 720p פֿאַר 1280×720 אָדער 720×1280 רעזולטאַט, אָדער 480p פֿאַר 832×480 אָדער 480×832 רעזולטאַט. די אָריענטאַציע פֿונעם קוואַל־ווידעא באַשטימט וועלכע דימענסיעס גילטן.

סטאַנדאַרט 81

באַגרענעצט וויפֿל ראַמען צו שאַפֿן; אויב דער קוואַל אַנטהאַלט ווייניקער ראַמען, ווערט זײַן ראַם־צאָל דער אויבערשטער גרענעץ.

פֿאָרגעשריטן segmentation_prompt · num_inference_steps · guidance_scale · vace_scale · seed · enable_safety_checker · keyframes
0 / 100

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

סטאַנדאַרט 30

קוואַליטעט־און־גיכקייט־קאָנטראָל פֿאַר אַ Clip, אויסגעדריקט ווי דער diffusion sampling־טריט־צאָל פֿאַר יעדן Clip: מער טריט פֿאַרבעסערן קוואַליטעט, אָבער נעמען לענגער.

סטאַנדאַרט 5

Classifier-free guidance שטאַרקייט, וואָס באַלאַנסירט נאָכפֿאָלגן דעם פּראָמפּט קעגן קרעאַטיווקייט.

סטאַנדאַרט 1

סטרוקטורעלע געטרײַקייט צום קוואַל־ווידעא, אַדזשאַסטירט דורך דער VACE conditioning סקייל.

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

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

POST /run/id-v2v?wait=20 פּרײַז → ⁨$ 1.013⁩
# 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/id-v2v?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "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 שליסל

וועגן ID-V2V

רעגענערירט אַ מקור־ווידעאָ (`video_url`) אין דעם אויסזען פֿון אַ ריסטיילטער ערשטער־פֿרעם (`image_url`), געפֿירט דורך אַ `prompt`. ביז 5 `keyframes` קענען אַנקערן די אידענטיטעט אין לענגערע קליפּס. די רעזולטאַט איז 480p אָדער 720p מיט `num_frames` פֿון 17 ביז 241, און `segmentation_prompt` (לויטן באַשטעטיקונג person) אויסקלײַבט דעם סוביעקט וועמענס פּיקסעלן באַשטימען די רעזולטאַט.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptפארלאנגט
טיפּstring
פּראָמפּט וואָס ספּעציפֿיצירט דעם געוווּנטשטן ווידעא נאָך־סטיליזירט.
video_urlפארלאנגט video
טיפּurl · video
רעפֿערענץ פֿאַר באַוועגונג און קאַדורונג בעת גענערירונג, צוגעשטעלט ווי דער קוואַל־ווידעאָס URL.
image_urlפארלאנגט image
טיפּurl · image
רעפֿערענץ פֿאַר אידענטיטעט און סטיל בײַ ווידעא־ווידערגענערירונג, צוגעשטעלט ווי אַ URL צו דעם נאָך־סטיליזירטן ערשטן ראַם.
keyframesאָפּציאָנעל
טיפּobject[]
≤ 5 ייטעמס
אָפּציאָנאַלע אידענטיטעט־אַנקערס פֿאַר לאַנגע ווידעאָס: שטעלט צו נאָך־סטיליזירטע keyframes מיט די רעזולטאַט־ראַם־אינדיצעס וווּ זיי מוזן דערשײַנען.
keyframes[].image_urlפארלאנגט
טיפּurl · image
URL פֿון אַ נאָך־סטיליזירטן בילד פֿאַר אַן אידענטיטעט־אַנקער אין אַ לאַנגען ווידעא; דאָס בילדס אַספּעקט־פֿאַרהעלטעניש טאָר זיך אונטערשיידן פֿונעם רעזולטאַטס ניט מער ווי 0.1. דאָס בילד דערשײַנט אומגעענדערט בײַ `frame_index`.
keyframes[].frame_indexפארלאנגט
טיפּinteger
≥ 1
שטעלט דעם keyframe אויף אַ רעזולטאַט־פּאָזיציע פֿון לכל־הפּחות 1 און אונטער דער גאַנצער צאָל רעזולטאַט־ראַמען, מיט 0-based אינדעקסירונג. פּאָזיציע 0 איז רעזערווירט פֿאַרן נאָך־סטיליזירטן אָנהייב־ראַם פֿון `image_url`.
resolutionאָפּציאָנעל
טיפּenum
סטאַנדאַרט720p
480p720p
קלײַבט 720p פֿאַר 1280×720 אָדער 720×1280 רעזולטאַט, אָדער 480p פֿאַר 832×480 אָדער 480×832 רעזולטאַט. די אָריענטאַציע פֿונעם קוואַל־ווידעא באַשטימט וועלכע דימענסיעס גילטן.
num_framesאָפּציאָנעל
טיפּinteger
סטאַנדאַרט81
17 – 241
באַגרענעצט וויפֿל ראַמען צו שאַפֿן; אויב דער קוואַל אַנטהאַלט ווייניקער ראַמען, ווערט זײַן ראַם־צאָל דער אויבערשטער גרענעץ.
segmentation_promptאָפּציאָנעל
טיפּstring
סטאַנדאַרטperson
≤ 100 כאַראַקטערן
סוביעקט־אויסקלײַב־פּראָמפּט פֿאַר SAM-3, וואָס אידענטיפֿיצירט דעם געגנט וועמענס פּיקסעלן וועלן פֿירן די גענערירונג. אויסער דעם סעגמענטירטן סוביעקט איז די גענערירונג אומבאַגרענעצט.
num_inference_stepsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט30
2 – 40
קוואַליטעט־און־גיכקייט־קאָנטראָל פֿאַר אַ Clip, אויסגעדריקט ווי דער diffusion sampling־טריט־צאָל פֿאַר יעדן Clip: מער טריט פֿאַרבעסערן קוואַליטעט, אָבער נעמען לענגער.
guidance_scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט5
1 – 10
Classifier-free guidance שטאַרקייט, וואָס באַלאַנסירט נאָכפֿאָלגן דעם פּראָמפּט קעגן קרעאַטיווקייט.
vace_scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט1
0 – 2
סטרוקטורעלע געטרײַקייט צום קוואַל־ווידעא, אַדזשאַסטירט דורך דער VACE conditioning סקייל.
seedאָפּציאָנעל
טיפּinteger | null
צופֿעליקער זוימען שערד צווישן אַלע Clips בײַ גענערירן עטלעכע Clips, וואָס ערמעגלעכט רעפּראָדוצירבאַרע גענערירונג.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
אַקטיוויזירט זיכערקייט־קאָנטראָלן סײַ אויף אַרײַנגעבונגען סײַ אויף רעזולטאַטן.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "id-v2v",
  "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": 1013,
    "usd": "1.013",
    "charged": 1013,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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
  },
  "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סיד־ווערט וואָס ווערט געווענדט בעת גענערירונג.

מער מאָדעלן: ווידעא צו ווידעא

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