استخدم Luma في Hermes Agent.
يُعدِّل Luma Ray 3.2 مقاطع الفيديو الموجودة بتحولات مدفوعة بالمطالبات النصية تحافظ على التماسك المكاني وبنية المشهد ثلاثية الأبعاد. أرسل رابط فيديو مصدر ومطالبة نصية تصف التحويل المطلوب — يُعيد Luma تصيير اللقطات مع إضاءة جوية وتفاصيل بيئية وحركة كاميرا متسقة فيزيائياً. يستدعيها Hermes Agent من خلال نقطة النهاية المخصصة لـ RunAPI.
Use RunAPI to modify a video with Luma Ray 3.2.
Requirements:
- Read the API key from RUNAPI_API_KEY.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- Call POST https://runapi.ai/api/v1/luma/modify_video
- Set model to "luma-modify-video".
- Set source_video_url to the URL of the video to transform.
- Set prompt to describe the desired transformation.
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the modified video URL from the response output.
curl -X POST https://runapi.ai/api/v1/luma/modify_video \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "luma-modify-video",
"prompt": "Transform the scene into a foggy autumn morning with golden light filtering through trees",
"source_video_url": "https://example.com/park-walk.mp4"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "luma-modify-video"
}
استخدم Luma في Hermes Agent في ثلاث خطوات
هيّئ RunAPI
عيِّن RUNAPI_API_KEY في البيئة التي يعمل فيها Hermes Agent. إذا أضفت RunAPI مسبقاً كمزود custom:runapi، فإن نفس المفتاح يتعامل مع طلبات تعديل الفيديو باستخدام Luma.
export RUNAPI_API_KEY=runapi_xxx
استدعِ Luma modify_video
أرسل طلب POST إلى نقطة نهاية modify_video مع تعيين النموذج إلى luma-modify-video، وإشارة source_video_url إلى لقطاتك المصدر، ومطالبة تصف التحويل المطلوب. يمكن لـ Hermes Agent بناء هذا الطلب وإرساله من خلال مزود custom:runapi.
POST /api/v1/luma/modify_video
استطلع النتيجة
تُعيد نقطة النهاية task_id فوراً. استطلع نقطة نهاية حالة المهمة حتى تصبح الحالة "completed"، ثم اقرأ رابط الفيديو الناتج من الاستجابة. يستغرق تعديل الفيديو عادةً من 30 إلى 120 ثانية حسب التعقيد.
GET /api/v1/luma/modify_video/tsk_abc123
معاملات واجهة برمجة Luma modify_video
| المعامل | النوع | الوصف |
|---|---|---|
model |
string |
مطلوب. استخدم luma-modify-video. |
prompt |
string |
مطلوب. وصف نصي للتحويل المطلوب للفيديو — تغييرات الأسلوب، والإضاءة، والجو، أو تعديلات المشهد. |
source_video_url |
string |
مطلوب. رابط الفيديو المصدر المراد تعديله. يجب أن يكون ملف MP4 أو MOV متاحاً للعموم. |
watermark |
boolean |
اختياري. ما إذا كان سيتم إضافة علامة مائية إلى الفيديو الناتج. |
callback_url |
string |
اختياري. رابط Webhook يستقبل طلب POST عند اكتمال المهمة. |
ما هو Luma في Hermes Agent؟
Luma Ray 3.2 (Dream Machine) يُعيد عرض الفيديو الموجود بتحويلات مدفوعة بالتعليمات. يستدعيه Hermes Agent عبر RunAPI custom provider كخطوة تحرير فيديو في خطوط الأنابيب متعددة الخطوات.
حالات استخدام Luma
ريلز مفاهيمية وصور ثابتة متحركة
حوّل الفن المفاهيمي الثابت أو اللقطات الخام إلى ريلز فيديو مُصمَّمة للعروض التقديمية.
إعادة توظيف المحتوى الموسمي وإعلانات العلامة التجارية
أعد تصميم أصول الفيديو الموجودة للحملات الموسمية أو الاتجاهات الجديدة للعلامة التجارية أو اختبارات A/B.
محتوى مرئي تجريدي وسريالي
طبّق تحويلات سريالية أو تشكيلية أو تجريدية على الفيديو المصدر للمشاريع الفنية.
أسئلة Luma + Hermes Agent
يُعيد Luma modify_video تصيير اللقطات الموجودة بتغييرات مدفوعة بالمطالبات — تحولات جوية (ضباب، مطر، ساعة ذهبية)، ونقل الأساليب (سينمائي، أنيمي، نوار)، وتجديد الإضاءة، والتحولات البيئية. يحافظ على حركة الكاميرا الأصلية والتخطيط المكاني للمشهد.
أضف مزوداً مخصصاً باسم runapi في إعدادات Hermes Agent مع base_url بالقيمة https://runapi.ai/v1 و key_env بالقيمة RUNAPI_API_KEY. بمجرد الإعداد، يتعامل نفس المزود مع استدعاءات Luma modify_video إلى جانب الدردشة وطلبات نماذج RunAPI الأخرى.
غير متزامن. تُعيد نقطة نهاية الإنشاء task_id فوراً. استطلع نقطة نهاية حالة المهمة أو وفِّر callback_url لاستقبال Webhook عند جهوزية الفيديو المعدَّل. يستغرق وقت المعالجة النموذجي من 30 إلى 120 ثانية.
يستخدم Luma الفوترة الثابتة لكل مهمة — كل استدعاء modify_video يكلف مبلغاً ثابتاً بصرف النظر عن مدة الفيديو. راجع صفحة أسعار RunAPI للاطلاع على الأسعار الحالية. لا يُحاسَب على الأجيال الفاشلة.
نعم. يمكن لسير عمل Hermes Agent توليد فيديو باستخدام Kling أو Wan، ثم تمرير رابط الناتج كـ source_video_url إلى Luma modify_video لإعادة التصيير الجوي — كل ذلك من خلال نفس مزود custom:runapi و RUNAPI_API_KEY. تستخدم كل خطوة نفس نمط الاستطلاع غير المتزامن.
إعداد Hermes Agent العام
لم تُهيّئه بعد؟ ابدأ بدليل إعداد RunAPI لـ Hermes Agent.
دليل إعداد Hermes Agent →جرّب Luma في Hermes Agent اليوم.
احصل على مفتاح RunAPI مجاني، وهيّئ مزود custom:runapi، وابدأ تعديل الفيديو بتحولات Luma Ray 3.2 المدركة للفضاء.