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

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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 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/image-to-video.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt