דילוג לתוכן

Luma Ray 3.2 Image to Video

שילוב

מזהה מודל luma/agent/ray/v3.2/image-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/image-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"
  }'

# 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.15 ‏$⁩ 150 קרדיטי API · ≈ ⁨‏16.14 ‏₽⁩ הרצה בדף הזה

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

Ray 3.2 תמונה-לווידאו עם פריים סיום או עד 64 פריימי מפתח, לולאה ופלט HDR/EXR אופציונלי

Luma AI · ווידאו

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

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

בנה בקשה

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

•חובה 88 / 6000

תיאור טקסטואלי של הסצנה או התנועה ליצירה.

duration 5 s

משך הווידאו שנוצר. עוגן יחיד של image_url / end_image_url אינו יכול לתמוך ב־10s; משך זה דורש כמה פריימי מפתח שסופקו דרך keyframes / keyframe_indexes.

aspect_ratio ברירת מחדל 16:9

יחס הגובה-רוחב של הווידאו שהתקבל.

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

רזולוציית וידאו הפלט.

מתקדם image · end_image · loop · enable_safety_checker · keyframes · keyframe_indexes
image_url
גרור קובץ, או

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

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

כתובת URL אופציונלית של תמונת הפריים האחרון, המאפשרת אינטרפולציה מ־image_url אל end_image_url, כחלופה לשימוש בפריימי מפתח.

ספק 1–64 כתובות URL של תמונות כמדריכי תמונה לווידאו מרובי־פריימי־מפתח, יחד עם רשימת keyframe_indexes באותו אורך שמציינת את מיקומיהן. שימוש בפריימי מפתח מאפשר HDR ויצירה באורך 10s, אך מונע שימוש ב־image_url, end_image_url וב־loop.

מיקומי עוגנים המשויכים לפריימי מפתח: רשומה [i] ממקמת את keyframes[i] בפלט, ולשני המערכים חייב להיות אורך זהה. המיקומים חייבים להיות שונים ואי־שליליים; duration × 24fps נותן טווחים של 0–120 עבור 5s ושל 0–240 עבור 10s.

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

# 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 Image to Video

מנפיש את `image_url` כפריים הראשון, עם `end_image_url` אופציונלי, או משתמש ב-`keyframes` עם `keyframe_indexes` (1 עד 64) במקום זאת. יחסי הממדים נעים מ-3:4 עד 21:9, הרזולוציה היא 540p, 720p או 1080p, ו-`duration` הוא 5s או 10s, כאשר 10s דורש פריימים מפתח. `loop`, `hdr` ו-`exr_export` זמינים בתנאים המצוינים. מגבלת ההנחיה היא 6000 תווים.

פרמטרים

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

שםסוג ברירת מחדלמותר תיאור
promptחובה
סוגstring
≤ 6,000 תווים
תיאור טקסטואלי של הסצנה או התנועה ליצירה.
image_urlאופציונלי image
סוגurl · image
כתובת URL של תמונת הפריים הראשון שסופקה דרך image_url, המאפשרת מלווה אופציונלי end_image_url. מצב עיגון זה אינו כולל פריימי מפתח; יש לבחור מצב אחד, לא את שניהם.
end_image_urlאופציונלי end_image
סוגurl · image
כתובת URL אופציונלית של תמונת הפריים האחרון, המאפשרת אינטרפולציה מ־image_url אל end_image_url, כחלופה לשימוש בפריימי מפתח.
aspect_ratioאופציונלי
סוגenum
ברירת מחדל16:9
3:44:31:19:1616:921:9
יחס הגובה-רוחב של הווידאו שהתקבל.
resolutionאופציונלי
סוגenum
ברירת מחדל540p
540p720p1080p
רזולוציית וידאו הפלט.
durationאופציונלי
סוגenum
ברירת מחדל5s
5s10s
משך הווידאו שנוצר. עוגן יחיד של image_url / end_image_url אינו יכול לתמוך ב־10s; משך זה דורש כמה פריימי מפתח שסופקו דרך keyframes / keyframe_indexes.
loopאופציונלי
סוגboolean
ברירת מחדלfalse
יצירת לולאה חלקה, מוגבלת לפלט בטווח דינמי רגיל; ציון פריים סיום או פריימי מפתח הופך אפשרות זו ללא זמינה.
hdrאופציונלי
סוגboolean
ברירת מחדלfalse
קידוד HDR לפלט MP4, זמין ב־720p או 1080p לחשבונות עם גישת HDR. יש להשבית לולאה כדי להשתמש בו.
exr_exportאופציונלי
סוגboolean
ברירת מחדלfalse
ייצוא EXR נוסף המצורף ל־MP4, זמין רק עם גישת HDR ו־hdr=true.
keyframesאופציונלי
סוגstring[]
≤ 64 פריטים
ספק 1–64 כתובות URL של תמונות כמדריכי תמונה לווידאו מרובי־פריימי־מפתח, יחד עם רשימת keyframe_indexes באותו אורך שמציינת את מיקומיהן. שימוש בפריימי מפתח מאפשר HDR ויצירה באורך 10s, אך מונע שימוש ב־image_url, end_image_url וב־loop.
keyframe_indexesאופציונלי
סוגinteger[]
≤ 64 פריטים
מיקומי עוגנים המשויכים לפריימי מפתח: רשומה [i] ממקמת את keyframes[i] בפלט, ולשני המערכים חייב להיות אורך זהה. המיקומים חייבים להיות שונים ואי־שליליים; duration × 24fps נותן טווחים של 0–120 עבור 5s ושל 0–240 עבור 10s.
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/image-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": 150,
    "usd": "0.15",
    "charged": 150,
    "refunded": 0
  },
  "input": {
    "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
    },
    "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/image-to-video.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt