דילוג לתוכן

Luma Ray 3.2 Video to Video

שילוב

מזהה מודל luma/agent/ray/v3.2/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/luma/agent/ray/v3.2/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.72 ‏$⁩ 720 קרדיטי API · ≈ ⁨‏77.27 ‏₽⁩ הרצה בדף הזה

קבלת מפתח API
Luma AI ווידאו לווידאו סנכרון שפתיים5–10 שניותעד 1080p #stylized#transform#lipsync

עריכת וידאו של Ray 3.2 שמשנה את סגנון סרטון המקור באמצעות הגדרות עוצמת עריכה, בקרות ופריימי מפתח

Luma AI · ווידאו

התוצאה הראשונה שלך תופיע כאן

בנו בקשה למטה והריצו אותה עם מפתח ה־API שלכם. הפלטים מועתקים לאחסון שלנו ונשמרים לצמיתות או למשך 7 ימים ללא תשלום.

בנה בקשה

הפקדים נוצרים מסכמת המודל. הקוד והמחיר מתעדכנים כשמשנים אותם.

•חובה 88 / 6000

הנחיות טקסט לעריכת וידאו המקור.

•חובה video_url
גרור קובץ, או

כתובת URL של הווידאו לעריכה.

duration 5 s

אורך הווידאו לאחר העריכה.

resolution ברירת מחדל 540p

רזולוציית הפלט לאחר העריכה.

מתקדם image · user · edit_strength · auto_controls · enable_safety_checker · keyframes · controls · keyframe_indexes
start_image_url
גרור קובץ, או

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

מזהה אטום אופציונלי המזהה את משתמש הקצה ששולח את הבקשה.

הגדרת שימור המקור לעריכות, זמינה רק כאשר auto_controls אינו בשימוש; השמטה בוחרת את ברירת המחדל של המודל. מהתרחקות הגדולה ביותר לדבקות הקרובה ביותר, האפשרויות הן 'reimagine_*', 'flex_*' לתוצאה מאוזנת ו־'adhere_*'.

מדריכי עריכה מרובי־פריימי־מפתח שסופקו ככתובות URL של תמונות במקום start_image_url. ספק keyframes יחד עם מערך keyframe_indexes באותו אורך כדי להצמיד כל תמונה למיקום הפריים שלה בווידאו המקור; מותרות לכל היותר 64 כתובות URL.

חלופה מפורטת ל־edit_strength, המגדירה התניה בנפרד עבור תנוחה, עומק, נורמלים, מסלול ופנים. שימוש בבקרים אלה מונע שימוש ב־auto_controls.

מיפוי פריימי המקור המשויך אחד־לאחד ל־keyframes: רשומה [i] מציינת את מיקום העוגן עבור keyframes[i]. לשני המערכים חייב להיות אורך זהה, והמיקומים חייבים להיות שונים ואי־שליליים.

POST /run/luma/agent/ray/v3.2/video-to-video?wait=20 הצעת מחיר → ⁨‏0.72 ‏$⁩
# 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/luma/agent/ray/v3.2/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

מידע על Luma Ray 3.2 Video to Video

עורך `video_url` לפי `prompt`, עם `start_image_url` אופציונלי להכוונת הפריים הראשון. `edit_strength` מציע את הרמות adhere, flex ו-reimagine מ-1 עד 3, בעוד `auto_controls` או אובייקט `controls` מספקים התניה חלופית. ניתן לעגן עד 64 `keyframes` באמצעות `keyframe_indexes`. הפלט הוא 540p עד 1080p, באורך 5s או 10s, עם `hdr` ו-`exr_export` אופציונליים.

פרמטרים

שלח את השם הקנוני או את השם המקומי, לא את שניהם. שמות קנוניים

שםסוג ברירת מחדלמותר תיאור
promptחובה
סוגstring
≤ 6,000 תווים
הנחיות טקסט לעריכת וידאו המקור.
video_urlחובה video
סוגurl · video
כתובת URL של הווידאו לעריכה.
userאופציונלי
סוגstring | null
מזהה אטום אופציונלי המזהה את משתמש הקצה ששולח את הבקשה.
start_image_urlאופציונלי image
סוגurl · image
עקיפת פריים ראשון עבור הווידאו הערוך, המסופקת ככתובת URL אופציונלית של תמונה; כאשר היא מושמטת, המודל מפיק את הפריים הזה מווידאו המקור. לדוגמה, אספקת תמונת פתיחה שעברה שינוי סגנון מתוך המקור יכולה להנחות את מראה העריכה.
resolutionאופציונלי
סוגenum
ברירת מחדל540p
540p720p1080p
רזולוציית הפלט לאחר העריכה.
durationאופציונלי
סוגenum
ברירת מחדל5s
5s10s
אורך הווידאו לאחר העריכה.
edit_strengthאופציונלי
סוגenum
adhere_1adhere_2adhere_3flex_1flex_2flex_3reimagine_1reimagine_2reimagine_3
הגדרת שימור המקור לעריכות, זמינה רק כאשר auto_controls אינו בשימוש; השמטה בוחרת את ברירת המחדל של המודל. מהתרחקות הגדולה ביותר לדבקות הקרובה ביותר, האפשרויות הן 'reimagine_*', 'flex_*' לתוצאה מאוזנת ו־'adhere_*'.
auto_controlsאופציונלי
סוגboolean
ברירת מחדלfalse
התניית עריכה אוטומטית: המודל משתמש בווידאו המקור כדי לקבוע את לוח הזמנים במקום לקבל edit_strength לצד אפשרות זו.
hdrאופציונלי
סוגboolean
ברירת מחדלfalse
קידוד HDR לפלט MP4 ב־720p או 1080p, זמין רק לחשבונות עם גישת HDR.
exr_exportאופציונלי
סוגboolean
ברירת מחדלfalse
ייצוא EXR נוסף המצורף ל־MP4, זמין רק עם גישת HDR ו־hdr=true.
controlsאופציונלי
סוגobject
חלופה מפורטת ל־edit_strength, המגדירה התניה בנפרד עבור תנוחה, עומק, נורמלים, מסלול ופנים. שימוש בבקרים אלה מונע שימוש ב־auto_controls.
controls.poseאופציונלי
סוגobject
התניה המבוססת על תנוחה או שלד.
controls.pose.enabledאופציונלי
סוגboolean
ברירת מחדלtrue
מתג להתניה על תנוחה או שלד במהלך העריכה.
controls.pose.strengthאופציונלי
סוגenum
precisecoarse
בחירת דיוק ההתניה על תנוחה: השמט כדי לשמור על ברירת המחדל, בחר 'coarse' לחופש רב יותר, או השתמש ב־'precise' כדי לעקוב מקרוב אחר תנוחת המקור.
controls.depthאופציונלי
סוגobject
התניה המבוססת על עומק או על גאומטריית הסצנה.
controls.depth.enabledאופציונלי
סוגboolean
ברירת מחדלtrue
מתג להתניה על עומק או על גאומטריית הסצנה במהלך העריכה.
controls.depth.blurאופציונלי
סוגnumber | null
0 – 1
הגדרת טשטוש עומק, שנותרת ללא ציון כדי לשמור על ברירת המחדל או מוגדלת כדי להעניק לגאומטריה חופש רב יותר.
controls.normalsאופציונלי
סוגobject
התניה המבוססת על נורמלים של פני השטח.
controls.normals.enabledאופציונלי
סוגboolean
ברירת מחדלtrue
מתג להתניה על נורמלים של פני השטח במהלך העריכה.
controls.normals.augmentationאופציונלי
סוגnumber | null
0 – 1
הגדרת העשרה של נורמלים של פני השטח; השמט כדי לשמור על ברירת המחדל, או הגדל כדי לאפשר פרשנות מחודשת רבה יותר של גאומטריית פני השטח.
controls.trajectoryאופציונלי
סוגobject
התניה המבוססת על מסלולי תנועה.
controls.trajectory.enabledאופציונלי
סוגboolean
ברירת מחדלtrue
מתג להתניה על מסלולי תנועה במהלך העריכה.
controls.trajectory.sparsityאופציונלי
סוגnumber | null
0 – 1
הגדרת דלילות מסלולי התנועה; השמט כדי לשמור על ברירת המחדל, או הגדל כדי להפחית את מספר עוגני התנועה שבשימוש.
controls.faceאופציונלי
סוגobject
התניה המבוססת על זהות הפנים.
controls.face.enabledאופציונלי
סוגboolean
ברירת מחדלtrue
מתג להתניה על זהות הפנים במהלך העריכה.
keyframesאופציונלי
סוגstring[]
≤ 64 פריטים
מדריכי עריכה מרובי־פריימי־מפתח שסופקו ככתובות URL של תמונות במקום start_image_url. ספק keyframes יחד עם מערך keyframe_indexes באותו אורך כדי להצמיד כל תמונה למיקום הפריים שלה בווידאו המקור; מותרות לכל היותר 64 כתובות URL.
keyframe_indexesאופציונלי
סוגinteger[]
≤ 64 פריטים
מיפוי פריימי המקור המשויך אחד־לאחד ל־keyframes: רשומה [i] מציינת את מיקום העוגן עבור keyframes[i]. לשני המערכים חייב להיות אורך זהה, והמיקומים חייבים להיות שונים ואי־שליליים.
enable_safety_checkerאופציונלי
סוגboolean
ברירת מחדלtrue
ניתן להקל את הסינון באמצעות הגדרה ל-false, אם הצד הקורא מורשה לכך.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 10 MB, או את file_url של העלאה. קבצים

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "luma/agent/ray/v3.2/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": 720,
    "usd": "0.72",
    "charged": 720,
    "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
    },
    "exr_file": {
      "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
    }
  },
  "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}וידאו שהופק על ידי המודל.
exr_file
object {url, content_type, file_name, file_size} | nullקובץ EXR נלווה בפורמט הייצוא של Luma: קובץ EXR אחד או ארכיון ZIP. הוא נוצר כאשר exr_export הוא true.

מודלים נוספים: ווידאו לווידאו

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/luma/agent/ray/v3.2/video-to-video.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt