curl-X POST 'https://pollo.ai/api/platform/v1/generation/luma/luma-ray-2/video'\-H'Content-Type: application/json'\-H'x-api-key: YOUR_API_KEY'\-d'{ "input": { "prompt": "A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field", "duration": 5, "aspectRatio": "16:9", "resolution": "540p" }}'
İsteğe bağlı olarak, görev başarılı veya başarısız olduğunda geri bildirim almak için webhookUrl'yi ekleyebilirsiniz.
İsteğe bağlı istek alanı
{"input":{"prompt":"A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field","duration":5,"aspectRatio":"16:9","resolution":"540p"},"webhookUrl":"https://example.com/webhooks/pollo"}
Şema
Seçilen uç nokta ve mod için giriş alanları.
Alan
Tip
Gerekli
Tanım
prompt
string
Evet
Text prompt describing the content to generate.
duration
number
HAYIR
The duration of the generated video, in seconds.
aspectRatio
string
HAYIR
Output aspect ratio, as width:height (e.g. 16:9).
resolution
string
HAYIR
Output resolution of the generated media (e.g. 720p, 1080p, 2K, 4K). Values are case-insensitive.
حدّد إطار بداية، وحدّد إطار نهاية، ودَع Luma Ray 2.0 يملأ الحركة بينهما. صُمّم هذا التحكم عبر الإطارات المفتاحية لمعالجة الانتقالات الموجّهة واللقطات الغنية بالمؤثرات.
من خلال Luma Ray 2.0 على Pollo API، يضيف المطوّرون إنشاء الفيديو من النص وإنشاء الفيديو من الصورة إلى تطبيقاتهم، مع توسيع المخرجات حتى 4K عبر نسب العرض إلى الارتفاع العريضة والعمودية والفائقة العرض.
الميزات الرئيسية لـ Luma Ray 2.0 API
التحكم في إطار البداية وإطار النهاية
زوّد صورة أولى وصورة نهائية، وسيبني Luma Ray 2.0 الحركة بينهما، ليمنحك بداية ونهاية محددتين لانتقالات مضبوطة.
حركة مدفوعة بالمؤثرات
تم تحسين النموذج للمؤثرات البصرية والحركة الديناميكية، ويعالج تحديدًا التحولات المعقدة، وعمليات التحوّل الشكلي، وتسلسلات الحركة العالية.
دقة تصل إلى 4K
تتراوح الدقات المدعومة من 540p للمسودات إلى 4K للإخراج النهائي، ما يتيح تشغيل العمليتين عبر تكامل API واحد.
نطاق واسع لنِسَب العرض إلى الارتفاع
من 21:9 فائق العرض إلى 9:21 الطولي، يتوافق Luma Ray 2.0 مع موجزات المحتوى، وإطارات السينما سكوب، والمواضع المربعة، بحيث يغطي نموذج واحد تنسيقات إخراج مختلفة جدًا.
توجيه بالنص والصورة
ابدأ من prompt مكتوب أو وجّه اللقطة انطلاقًا من صورة مرجعية، لتتمكن سير العمل القائم على الفكرة أولًا والقائم على الأصول أولًا من مشاركة نفس استدعاء الإنشاء.
حالات استخدام Luma Ray 2.0 API
انتقالات بإطارات مفتاحية: حدّد صورة افتتاحية وصورة ختامية ودَع النموذج يحرّك المسار بينهما، وهذا مفيد لبناء الشعارات وتغييرات المشاهد.
مقاطع التحوّل الشكلي والتحويل: حوّل عنصرًا إلى آخر، مثل رسم تخطيطي يصبح لوحة، حيث تقود المؤثرات البصرية اللقطة.
لقطات تأسيسية فائقة العرض: أنشئ بانوراما 21:9 للمناظر الطبيعية أو البيئات للألعاب والإعلانات الترويجية وأدوات السرد بالصيغة العريضة.
حركة اجتماعية عمودية: أنشئ مقاطع 9:16 بحركة نابضة لتطبيقات المحتوى القصير دون قص مصدر عريض الشاشة.
حركة منتجات بدقة 4K: اعرض حلقات عالية الدقة لأجسام تدور أو تتجمع أو تتفاعل لصفحات التجارة الإلكترونية وصفحات العرض التي تتطلب تفاصيل دقيقة.
تحريك موجّه بالصورة: أدخل صورة ثابتة وحرّكها إلى لقطة متحركة مع الحفاظ على الإطار الأصلي كما هو.
نمذجة أولية للمؤثرات: دع مصممي الحركة يعاينون انتقالًا أو فكرة مدفوعة بالجسيمات بسرعة قبل الالتزام بإخراج كامل.
كيفية استخدام Luma Ray 2.0 API
احصل على مفتاح API: أنشئ حساب Pollo API وولّد مفتاح API الخاص بك من لوحة تحكم المطوّر.
اختر النموذج: أرسل الطلبات إلى نقطة نهاية Luma Ray 2.0 على /generation/luma/luma-ray-2-0.
أضف مدخلاتك: قدّم prompt لإنشاء الفيديو من النص، أو image لإنشاء الفيديو من الصورة مع imageTail اختياري كإطار نهاية، ثم حدّد resolution (من 540p إلى 4k) وlength (5 أو 9) وaspectRatio.
أنشئ واسترجع: أرسل المهمة، وتابع حالة المهمة المُعادة، ونزّل الفيديو بمجرد نجاحها.
أفضل ممارسات كتابة الأوامر لـ Luma Ray 2.0 API
اكتب من أجل الحركة والتغيير. اذكر العنصر، والتحوّل أو الإجراء، وسلوك الكاميرا، والمزاج، حتى يحصل النموذج على هدف واضح لحركته المدفوعة بالمؤثرات.
صيغة بسيطة لكتابة prompt
العنصر + كيف يتحرك أو يتحول + حركة الكاميرا + المكان والإضاءة + لمسة أسلوبية أو إشارة مؤثر
ما يجب أن تنتبه له
صِف التغيير: وضّح كيف يتطور المشهد، مثل يتحوّل شكليًا أو يتمدّد أو يتلاشى، حتى يكون للحركة اتجاه.
استخدم كلا الإطارين: اجمع بين صورة بداية وصورة نهائية عندما تحتاج بداية ونهاية دقيقتين.
طابِق الدقة مع الهدف: ابدأ بمسودة على 540p، ثم أعد الإخراج على 1080p أو 4K للتفاصيل النهائية.
وجّه الكاميرا: أضف تقريبًا للداخل، أو دورانًا محيطيًا، أو تحريكًا أفقيًا لتشكيل كيفية ظهور المؤثر عبر المقطع.
أمثلة على prompts
تحوّل من رسم تخطيطي إلى لوحة
"رسم بقلم رصاص لسلسلة جبال يمتلئ ببطء بالألوان والملمس، ليصبح لوحة زيتية مكتملة. تظهر ضربات الفرشاة عبر القماش، إضاءة معرض دافئة، تقريب بطيء للداخل، تحوّل سلس مع تفاصيل فنية واضحة."
كشف منظر طبيعي فائق العرض
"طائرة مسيّرة تنساب فوق وادٍ جبلي ضبابي عند الفجر بينما يخترق الضوء القمم ويرتفع الضباب من غابة الصنوبر بالأسفل. تأطير فائق العرض 21:9، حركة اندفاعية واسعة إلى الأمام، إضاءة ذهبية ناعمة، أسلوب طبيعي واقعي."
تأثير الحبر في الماء
"قطرة حبر أسود تضرب ماءً صافياً وتنتشر للخارج، مع خيوط تلتف وتتشابك حتى تشكل هيئة سمكة كوي. منظور جانبي ماكرو، خلفية داكنة، انجراف لطيف، حركة سائلة عالية التفاصيل."
بناء عنصر بإطارات مفتاحية
"قطع ميكانيكية متناثرة تطفو في استوديو مظلم، ثم تتجمع قطعة تلو الأخرى لتصبح ساعة يد كرومية مصقولة. البداية بمكوّنات مفككة، والنهاية بالساعة المكتملة، كاميرا تدور ببطء، إضاءة عاكسة حادة، تفاصيل 4K."
Luma Ray 2.0 مقابل Runway Gen-3 مقابل Kling 2.1
الإمكانية
Luma Ray 2.0
Runway Gen-3
Kling 2.1
التحكم في إطار البداية وإطار النهاية
✅ صورة بداية مع صورة نهائية
✅ إطارات مفتاحية بداية ونهاية
✅ إطارا بداية ونهاية
أقصى دقة
حتى 4K
حتى 720p/1080p
حتى 1080p
نطاق نسبة العرض إلى الارتفاع
16:9 إلى 21:9، و9:16 إلى 9:21، و1:1
إعدادات مسبقة محدودة
إعدادات مسبقة شائعة
المؤثرات البصرية والتحوّلات الشكلية
✅ قوي
✅ جيد
✅ جيد
طول المقطع
5 أو 9 ثوانٍ
مقاطع قصيرة
5 أو 10 ثوانٍ
يُنصح به لـ
انتقالات عالية الدقة ومدفوعة بالمؤثرات
لقطات موجّهة بطابع أسلوبي
حركة الشخصيات والأفعال
لماذا تختار Luma Ray 2.0 API؟
يتناسب Luma Ray 2.0 مع المنتجات المبنية حول الحركة والتحوّل، من الانتقالات بالإطارات المفتاحية إلى التحوّلات الشكلية، مع دقة تتدرج حتى 4K وتأطير من فائق العرض إلى العمودي.
من خلال Pollo API، يمكنك الوصول إلى Luma Ray 2.0 بمفتاح API واحد إلى جانب أكثر من 300 نموذج رائد للفيديو والصور، مع توثيق واضح وتتبع حالة المهام.
ابدأ بنقطة نهاية Luma Ray 2.0 لإطلاق ميزات فيديو عالية الدقة ومدفوعة بالمؤثرات، ثم قارنه مع Runway وKling وVeo بدون أي تعديل على تكاملك.
الأسئلة الشائعة حول Luma Ray 2.0 API
ما هو Luma Ray 2.0؟
Luma Ray 2.0 هو نموذج لإنشاء الفيديو من Luma AI يركّز على المؤثرات البصرية والحركة التفصيلية، ويدعم إنشاء الفيديو من النص ومن الصورة مع التحكم في إطار البداية وإطار النهاية.
هل يدعم Luma Ray 2.0 API إطاري البداية والنهاية؟
نعم. يمكنك تزويد صورة أولى وصورة نهائية، ويولّد النموذج الحركة بينهما لانتقالات وتحولات شكلية مضبوطة.
ما الدقات والأطوال المتاحة؟
يُخرج Luma Ray 2.0 بدقات 540p و720p و1080p أو 4K، مع أطوال مقاطع 5 أو 9 ثوانٍ يتم اختيارها لكل طلب.
ما نِسَب العرض إلى الارتفاع التي يمكنه إنشاؤها؟
يدعم التأطير العريض والعمودي والمربع وفائق العرض، بما في ذلك 21:9 و9:21، بحيث يغطي نموذج واحد تنسيقات السينما والاجتماعي والتضمين.
في ماذا يتفوق Luma Ray 2.0؟
يتفوق في الحركة الغنية بالمؤثرات والتحوّلات، ما يجعله مناسبًا للانتقالات والتحوّلات الشكلية واللقطات عالية الدقة التي تقودها الحركة.
لماذا تشغيل Luma Ray 2.0 عبر Pollo API؟
يوفّر Pollo API تكاملًا واحدًا لـ Luma Ray 2.0 وأكثر من 300 نموذج آخر، مع التوثيق وتتبع المهام.
