تخطّي إلى المحتوى

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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 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.

مزيد من النماذج: من فيديو إلى فيديو

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/luma/agent/ray/v3.2/video-to-video.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt