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

Ltx 2.3 Quality · Reference Video to Video

אינטעגרירן

מאָדעל־id ltx-2.3-quality/reference-video-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ltx-2.3-quality/reference-video-to-video?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"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

פֿײַלן ווי דער בײַשפּיל: ⁨$ 0.27⁩ 270 API־קרעדיטן · ≈ ⁨₽ 29.05⁩ אײַערע פֿײַלן ווערן געמאסטן איידערן לויפֿן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Lightricks ווידעא צו ווידעא געבוירענער אַודיאָ

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

Lightricks · ווידעא

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

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

בויען אַ בעטן

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

•פארלאנגט

פּראָמפּט וואָס ווערט גענוצט צו דיריגירן די גענערירונג.

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

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

resolution סטאַנדאַרט auto

די דימענסיעס פֿונעם רעזולטאַט־ווידעא, וואָס ווירקן אויך אויף דער סטאַבילער דויער: קלענערע דימענסיעס דערלויבן מער ראַמען, בעת גרעסערע פֿאַרקלענערן דעם מאַקסימום. די אײַנגעבויטע קאָנטראָל־אָפּשאַצונג האַלט די דימענסיעס נאָענט צום אָפֿיציעלן קאָנטראָל־אַרבעטסגאַנג; דירעקטער קאָנטראָל דורך `skip_control_preprocess` און `control_video_url` נוצט אַנשטאָט די בפֿירוש אָנגעגעבענע דימענסיעס, אויסגעגליכן צו 64px. אינעם דירעקטן קאָנטראָל־מאָדוס נעמט `auto` איבער די דימענסיעס און דאָס זײַטן־פֿאַרהעלטעניש פֿונעם מקור, אין די גרענעצן פֿון LTX.

סטאַנדאַרט 121

צאָל רעזולטאַט־ראַמען, אונטער אַ IC-LoRA־סטאַביליטעט־בודזשעט לויט רעזאָלוציע × ראַמען. א 422־ענטפער מיינט אַז דער בודזשעט איז איבערגעגאַנגען; נידעריקט די רעזאָלוציע אָדער `num_frames`.

פֿאָרגעשריטן negative_prompt · control_video_url · image · mid_image_url · end_image · video_quality · video_write_mode · video_strength · strength · frames_per_second · num_inference_steps · guidance_scale · seed · skip_control_preprocess · preserve_original_video · enable_prompt_expansion · enable_safety_checker
סטאַנדאַרט color distortion, ove...

נעגאַטיווער פּראָמפּט וואָס ספּעציפֿיצירט וואָס די גענערירונג זאָל אויסמײַדן.

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

אָפּציאָנאַלע פֿריִער־גערעכנטע קאָנטראָל־ווידעא, גענוצט אַנשטאָט פֿון אינערלעכער קאָנטראָל־אָפּשאַצונג צוזאַמען מיט `skip_control_preprocess`.

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

אָפּציאָנאַלע בילד־אַנקער־סטיל אָדער כאַראַקטער־אידענטיטעט ווי דער keyframe פֿון דער ערשטער ראַם.

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

אָפּציאָנאַלע אויסזען־אַנקערונג לעבן מיטן קליפּ, וואָס באַנוצט דעם ערשטן `image_url`־keyframe; דאַרף `image_url`.

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

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

video_quality סטאַנדאַרט high

קוואַליטעט־פּריסעט וואָס ווערט געווענדט צום רעזולטאַט־ווידעא.

video_write_mode סטאַנדאַרט balanced

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

סטאַנדאַרט 0.6

די באַוועגונג און סטרוקטור פֿון דער רעפֿערענץ־ווידעא ווערן קאַנטראָלט דורך דער conditioning־שטאַרקייט; קלענערע באַשטעטיקונגען דערלויבן גרעסערע ענדערונגען.

סטאַנדאַרט 1

Denoising־קאָנטראָל פֿאַר רעפֿערענץ־ווידעא־צו־ווידעא־סאַמפּלינג, אָפענגיק אויף `preserve_original_video`. מיטן מאָדוס אויס רעכנט עס נאָר דעם פּלאַן קירצער; מיטן מאָדוס אָן קאָנטראָלירט עס די טראַנספֿאָרמאַציע פֿון מקור־פּיקסעלן.

סטאַנדאַרט 24

רעזולטאַט־ווידעא־ראַם־קורס, געמאסטן אין ראַמען פּער סעקונדע.

סטאַנדאַרט 15

שטעלט וויפֿל inference־שריט צו לויפֿן, ביז 30; אויב מען ענדערט עס נישט, ווערן גענוצט 15.

סטאַנדאַרט 1

פּאַסט classifier-free guidance מיט דעם מאָסשטאַב; זײַן סטאַנדאַרט־טונירונג צילט אויף סײַ הויך קוואַליטעט סײַ שנעלע גענערירונג.

סיד וואָס מאכט גענערירונג רעפּראָדוצירבאַר. אויב מען שטעלט עס אויף None, ווערט אַ סיד ראַנדאָם אויסגעקליבן.

POST /run/ltx-2.3-quality/reference-video-to-video?wait=20 פּרײַז → ⁨$ 0.27⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ltx-2.3-quality/reference-video-to-video?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"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Ltx 2.3 Quality · Reference Video to Video

שאַפֿט אַ נײַעם ווידעאָ פֿון אַ נייטיקן `prompt` און אַ רעפֿערענץ־`video_url` וואָס צושטעלט באַוועגונג און סטרוקטור. אָפּציאָנעלע `image_url`, `mid_image_url` און `end_image_url` פֿאַראַנקערן דעם אויסזען בײַם אָנהייב, אין מיטן און בײַם סוף. `video_strength` און `strength` (ביידע 0 ביז 1) קאָנטראָלירן ווי נאָענט עס גייט נאָך דעם מקור אָדער וויפֿל עס היט אים, און `control_video_url` קען צושטעלן אַ פֿריִער אויסגערעכנטן קאָנטראָל־סיגנאַל. `resolution` אָפפערט אָטאָ אָדער פֿעסטע פּריסעטן ווי קוואַדראַט און 16:9 פּאָרטרעט אָדער לאַנדשאַפט.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptפארלאנגט
טיפּstring
פּראָמפּט וואָס ווערט גענוצט צו דיריגירן די גענערירונג.
video_urlפארלאנגט video
טיפּurl · video
URL צו אַ רעפֿערענץ־ווידעא וואָס גיידט באַוועגונג און סטרוקטור.
control_video_urlאָפּציאָנעל
טיפּurl · video
אָפּציאָנאַלע פֿריִער־גערעכנטע קאָנטראָל־ווידעא, גענוצט אַנשטאָט פֿון אינערלעכער קאָנטראָל־אָפּשאַצונג צוזאַמען מיט `skip_control_preprocess`.
skip_control_preprocessאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
דירעקטער קאָנטראָל־מאָדוס מיט `control_video_url` אַנשטאָט אינערלעך אָפּשאַצן טיפֿקייט, קאַנטן אָדער פּאָזע; אָן דעם URL ווערט די באַשטעטיקונג איגנאָרירט. אין דעם מאָדוס ווערן די בפֿירוש אָנגעגעבענע רעזולטאַט־דימענסיעס אויסגעגליכן צו 64, כּדי די RGB־ און קאָנטראָל־ווידעא זאָלן שטימען, בעת `auto` נעמט די דימענסיעס און דאָס זײַטן־פֿאַרהעלטעניש פֿונעם מקור, אין די גרענעצן פֿון LTX.
preserve_original_videoאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
מאָדוס פֿאַר אָפּהאַלטן דאָס אָריגינעלע ווידעא, נאָר מיט `skip_control_preprocess`, `video_url` און `control_video_url`. נידעריקערע `strength`־ווערטלעך האַלטן אָפּ מער אָריגינעלע פּיקסעלן.
image_urlאָפּציאָנעל image
טיפּurl · image
אָפּציאָנאַלע בילד־אַנקער־סטיל אָדער כאַראַקטער־אידענטיטעט ווי דער keyframe פֿון דער ערשטער ראַם.
mid_image_urlאָפּציאָנעל
טיפּurl · image
אָפּציאָנאַלע אויסזען־אַנקערונג לעבן מיטן קליפּ, וואָס באַנוצט דעם ערשטן `image_url`־keyframe; דאַרף `image_url`.
end_image_urlאָפּציאָנעל end_image
טיפּurl · image
אָפּציאָנאַלע אויסזען־אַנקערונג בײַם לעצטן ראַם; נוצלעך ווען דער אַפּאַראַט־באַוועגונג ענדיקט זיך אַנדערש ווי דאָס אָנהייב־בילד; דאַרף `image_url`.
video_strengthאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0.6
0 – 1
די באַוועגונג און סטרוקטור פֿון דער רעפֿערענץ־ווידעא ווערן קאַנטראָלט דורך דער conditioning־שטאַרקייט; קלענערע באַשטעטיקונגען דערלויבן גרעסערע ענדערונגען.
strengthאָפּציאָנעל
טיפּnumber
סטאַנדאַרט1
0 – 1
Denoising־קאָנטראָל פֿאַר רעפֿערענץ־ווידעא־צו־ווידעא־סאַמפּלינג, אָפענגיק אויף `preserve_original_video`. מיטן מאָדוס אויס רעכנט עס נאָר דעם פּלאַן קירצער; מיטן מאָדוס אָן קאָנטראָלירט עס די טראַנספֿאָרמאַציע פֿון מקור־פּיקסעלן.
num_framesאָפּציאָנעל
טיפּinteger
סטאַנדאַרט121
9 – 481
צאָל רעזולטאַט־ראַמען, אונטער אַ IC-LoRA־סטאַביליטעט־בודזשעט לויט רעזאָלוציע × ראַמען. א 422־ענטפער מיינט אַז דער בודזשעט איז איבערגעגאַנגען; נידעריקט די רעזאָלוציע אָדער `num_frames`.
resolutionאָפּציאָנעל
טיפּobject
סטאַנדאַרטauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
די דימענסיעס פֿונעם רעזולטאַט־ווידעא, וואָס ווירקן אויך אויף דער סטאַבילער דויער: קלענערע דימענסיעס דערלויבן מער ראַמען, בעת גרעסערע פֿאַרקלענערן דעם מאַקסימום. די אײַנגעבויטע קאָנטראָל־אָפּשאַצונג האַלט די דימענסיעס נאָענט צום אָפֿיציעלן קאָנטראָל־אַרבעטסגאַנג; דירעקטער קאָנטראָל דורך `skip_control_preprocess` און `control_video_url` נוצט אַנשטאָט די בפֿירוש אָנגעגעבענע דימענסיעס, אויסגעגליכן צו 64px. אינעם דירעקטן קאָנטראָל־מאָדוס נעמט `auto` איבער די דימענסיעס און דאָס זײַטן־פֿאַרהעלטעניש פֿונעם מקור, אין די גרענעצן פֿון LTX.
frames_per_secondאָפּציאָנעל
טיפּnumber
סטאַנדאַרט24
1 – 60
רעזולטאַט־ווידעא־ראַם־קורס, געמאסטן אין ראַמען פּער סעקונדע.
num_inference_stepsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט15
8 – 30
שטעלט וויפֿל inference־שריט צו לויפֿן, ביז 30; אויב מען ענדערט עס נישט, ווערן גענוצט 15.
guidance_scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט1
1 – 20
פּאַסט classifier-free guidance מיט דעם מאָסשטאַב; זײַן סטאַנדאַרט־טונירונג צילט אויף סײַ הויך קוואַליטעט סײַ שנעלע גענערירונג.
generate_audioאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
אַודיאָ־טראַק־באַשטימונג פֿאַר דעם צוריקגעגעבן MP4: אויסגעלאָשן פּראָדוצירט אַ ווידעא־בלויז פֿײַל, און אָנגעצונדן נעמט אַרײַן אַודיאָ.
negative_promptאָפּציאָנעל
טיפּstring
סטאַנדאַרטcolor distortion, overexposure, static, blurry details, subtitles, style, artwork, painting, frame, still, dim overall tone, worst quality, low quality, JPEG compression artifacts, ugly, mutilated, extra fingers, poorly drawn hands, poorly drawn face, deformed, disfigured, malformed limbs, fused fingers, motionless frame, cluttered background, three legs, crowded background, walking backwards
נעגאַטיווער פּראָמפּט וואָס ספּעציפֿיצירט וואָס די גענערירונג זאָל אויסמײַדן.
seedאָפּציאָנעל
טיפּinteger | null
סיד וואָס מאכט גענערירונג רעפּראָדוצירבאַר. אויב מען שטעלט עס אויף None, ווערט אַ סיד ראַנדאָם אויסגעקליבן.
enable_prompt_expansionאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קאָנטראָלירט צי פּראָמפּט־יקספּאַנשאַן איז אַקטיווירט.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קאָנטראָלירט צי זיכערהייט־קאָנטראָל זאָל זײַן אַקטיוו.
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": "ltx-2.3-quality/reference-video-to-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": 270,
    "usd": "0.27",
    "charged": 270,
    "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"
  },
  "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,
    "prompt": "string"
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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דער בפֿועל־Seed וואָס ווערט געווענדט בעת גענערירונג.
prompt
stringגענערירונג־פּראָמפּט, אַרײַנגערעכנט יעדע פֿאַרברייטערונג וואָס איז געווענדט געוואָרן איידערן נוצן.

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

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