דילוג לתוכן

Ltx 2.3 Quality · Reference Video to Video

שילוב

מזהה מודל 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`. התקציב מאפשר כ־150 פריימים במידות ברמת 720p, ויותר במידות קטנות יותר.

מתקדם 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
גרור קובץ, או

סגנון עיגון תמונה או זהות דמות אופציונליים, המשמשים כפריים המפתח הראשון.

גרור קובץ, או

מראה עיגון תמונה אופציונלי בקרבת אמצע הקליפ, המשלים את פריים המפתח ההתחלתי `image_url`. הוא מסייע למראה לעקוב אחר תנועת המצלמה במקום לסטות; דורש `image_url`.

end_image_url
גרור קובץ, או

מראה עיגון תמונה אופציונלי בפריים האחרון של הקליפ. שימושי כאשר תנועת המצלמה מסתיימת במיקום שונה מתמונת ההתחלה; דורש `image_url`.

video_quality ברירת מחדל high

קביעת איכות שהוחלה על וידאו הפלט.

video_write_mode ברירת מחדל balanced

מצב הכתיבה של הווידאו המתקבל.

ברירת מחדל 0.6

החופש לשנות תנועה ומבנה מווידאו העזר נשלט באמצעות עוצמת ההתניה הזו: הגדרות קטנות יותר מאפשרות שינויים גדולים יותר.

ברירת מחדל 1

שליטה בהסרת רעש לדגימה מווידאו עזר לווידאו, שהשפעתה תלויה ב־`preserve_original_video`. כאשר המצב כבוי, היא רק מקצרת את לוח הזמנים להסרת הרעש; כאשר הוא מופעל, היא שולטת בהמרת פיקסלי המקור, כאשר 1.0 יוצר הכול מחדש והגדרות נמוכות יותר משמרות יותר (לדוגמה, 0.5 משמר 50% בקירוב).

ברירת מחדל 24

קצב הפריימים של וידאו הפלט, נמדד בפריימים לשנייה.

ברירת מחדל 15

הגדירו כמה שלבי הסקה להפעיל, עד 30; השארת הערך ללא שינוי משתמשת ב-15.

ברירת מחדל 1

התאימו את ההנחיה ללא מסווג באמצעות סולם זה; כוונון ברירת המחדל שלו מיועד גם לאיכות גבוהה וגם ליצירה מהירה.

Seed שהופך את היצירה לניתנת לשחזור. הגדרתו ל-None בוחרת Seed באקראי.

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"

הרצת הבקשה הזו

המפתח שלך נשאר בדפדפן הזה: הוא נשלח רק אל 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` במקום הערכה פנימית של עומק, קצוות או תנוחה; ללא כתובת זו, ההגדרה מתעלמת. גודל הפלט במצב זה מכבד מידות מפורשות עם יישור ל־64 כדי לשמור על התאמה בין וידאו RGB לווידאו הבקרה, בעוד `auto` משתמש במידות המקור וביחס הגובה־רוחב שלו במסגרת מגבלות LTX.
preserve_original_videoאופציונלי
סוגboolean
ברירת מחדלfalse
מצב שימור וידאו המקור, זמין רק עם `skip_control_preprocess`, `video_url` ו־`control_video_url`. כברירת מחדל הוא מושבת ומשאיר את עיבוד הבקרה הרגיל ללא שינוי; הפעלתו מתחילה את היצירה מ־`video_url` תוך שמירת ההנחיה המבנית מ־`control_video_url`. הסרת רעש באמצעות `strength` קובעת את הכמות שנשמרת, כאשר הגדרות נמוכות יותר משמרות יותר פיקסלים מקוריים.
image_urlאופציונלי image
סוגurl · image
סגנון עיגון תמונה או זהות דמות אופציונליים, המשמשים כפריים המפתח הראשון.
mid_image_urlאופציונלי
סוגurl · image
מראה עיגון תמונה אופציונלי בקרבת אמצע הקליפ, המשלים את פריים המפתח ההתחלתי `image_url`. הוא מסייע למראה לעקוב אחר תנועת המצלמה במקום לסטות; דורש `image_url`.
end_image_urlאופציונלי end_image
סוגurl · image
מראה עיגון תמונה אופציונלי בפריים האחרון של הקליפ. שימושי כאשר תנועת המצלמה מסתיימת במיקום שונה מתמונת ההתחלה; דורש `image_url`.
video_strengthאופציונלי
סוגnumber
ברירת מחדל0.6
0 – 1
החופש לשנות תנועה ומבנה מווידאו העזר נשלט באמצעות עוצמת ההתניה הזו: הגדרות קטנות יותר מאפשרות שינויים גדולים יותר.
strengthאופציונלי
סוגnumber
ברירת מחדל1
0 – 1
שליטה בהסרת רעש לדגימה מווידאו עזר לווידאו, שהשפעתה תלויה ב־`preserve_original_video`. כאשר המצב כבוי, היא רק מקצרת את לוח הזמנים להסרת הרעש; כאשר הוא מופעל, היא שולטת בהמרת פיקסלי המקור, כאשר 1.0 יוצר הכול מחדש והגדרות נמוכות יותר משמרות יותר (לדוגמה, 0.5 משמר 50% בקירוב).
num_framesאופציונלי
סוגinteger
ברירת מחדל121
9 – 481
מספר פריימי הפלט, בכפוף לתקציב יציבות של IC-LoRA המבוסס על רזולוציה כפול מספר הפריימים. תגובת 422 פירושה שהתקציב חרג: יש להקטין את הרזולוציה או את `num_frames`. התקציב מאפשר כ־150 פריימים במידות ברמת 720p, ויותר במידות קטנות יותר.
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
הגדירו כמה שלבי הסקה להפעיל, עד 30; השארת הערך ללא שינוי משתמשת ב-15.
guidance_scaleאופציונלי
סוגnumber
ברירת מחדל1
1 – 20
התאימו את ההנחיה ללא מסווג באמצעות סולם זה; כוונון ברירת המחדל שלו מיועד גם לאיכות גבוהה וגם ליצירה מהירה.
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
Seed שהופך את היצירה לניתנת לשחזור. הגדרתו ל-None בוחרת Seed באקראי.
enable_prompt_expansionאופציונלי
סוגboolean
ברירת מחדלtrue
שולט אם הרחבת ההנחיה מופעלת.
enable_safety_checkerאופציונלי
סוגboolean
ברירת מחדלtrue
קובע אם בדיקת בטיחות מופעלת.
video_qualityאופציונלי
סוגenum
ברירת מחדלhigh
lowmediumhighmaximum
קביעת איכות שהוחלה על וידאו הפלט.
video_write_modeאופציונלי
סוגenum
ברירת מחדלbalanced
fastbalancedsmall
מצב הכתיבה של הווידאו המתקבל.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 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/he/developers/models/ltx-2.3-quality/reference-video-to-video.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt