---
title: "استخدام Luma في Hermes Agent عبر RunAPI — دليل واجهة برمجة الفيديو"
url: "https://runapi.ai/ar/hermes-luma.md"
canonical: "https://runapi.ai/ar/hermes-luma"
locale: "ar"
model: "luma"
---

# استخدم Luma في Hermes Agent.

يُعدِّل Luma Ray 3.2 مقاطع الفيديو الموجودة بتحولات مدفوعة بالمطالبات النصية تحافظ على التماسك المكاني وبنية المشهد ثلاثية الأبعاد. أرسل رابط فيديو مصدر ومطالبة نصية تصف التحويل المطلوب — يُعيد Luma تصيير اللقطات مع إضاءة جوية وتفاصيل بيئية وحركة كاميرا متسقة فيزيائياً. يستدعيها Hermes Agent من خلال نقطة النهاية المخصصة لـ RunAPI.

## API example

```bash
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"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "luma-modify-video"
}

```

## How it works

1. **هيّئ RunAPI** — عيِّن RUNAPI_API_KEY في البيئة التي يعمل فيها Hermes Agent. إذا أضفت RunAPI مسبقاً كمزود custom:runapi، فإن نفس المفتاح يتعامل مع طلبات تعديل الفيديو باستخدام Luma.
2. **استدعِ Luma modify_video** — أرسل طلب POST إلى نقطة نهاية modify_video مع تعيين النموذج إلى luma-modify-video، وإشارة source_video_url إلى لقطاتك المصدر، ومطالبة تصف التحويل المطلوب. يمكن لـ Hermes Agent بناء هذا الطلب وإرساله من خلال مزود custom:runapi.
3. **استطلع النتيجة** — تُعيد نقطة النهاية task_id فوراً. استطلع نقطة نهاية حالة المهمة حتى تصبح الحالة "completed"، ثم اقرأ رابط الفيديو الناتج من الاستجابة. يستغرق تعديل الفيديو عادةً من 30 إلى 120 ثانية حسب التعقيد.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | مطلوب. استخدم luma-modify-video. |
| `prompt` | `string` | مطلوب. وصف نصي للتحويل المطلوب للفيديو — تغييرات الأسلوب، والإضاءة، والجو، أو تعديلات المشهد. |
| `source_video_url` | `string` | مطلوب. رابط الفيديو المصدر المراد تعديله. يجب أن يكون ملف MP4 أو MOV متاحاً للعموم. |
| `watermark` | `boolean` | اختياري. ما إذا كان سيتم إضافة علامة مائية إلى الفيديو الناتج. |
| `callback_url` | `string` | اختياري. رابط Webhook يستقبل طلب POST عند اكتمال المهمة. |

## FAQ

### ما أنواع التحولات التي يمكن لـ Luma modify_video تنفيذها؟

يُعيد Luma modify_video تصيير اللقطات الموجودة بتغييرات مدفوعة بالمطالبات — تحولات جوية (ضباب، مطر، ساعة ذهبية)، ونقل الأساليب (سينمائي، أنيمي، نوار)، وتجديد الإضاءة، والتحولات البيئية. يحافظ على حركة الكاميرا الأصلية والتخطيط المكاني للمشهد.

### كيف أُهيّئ مزود custom:runapi لـ Luma في Hermes Agent؟

أضف مزوداً مخصصاً باسم runapi في إعدادات Hermes Agent مع base_url بالقيمة https://runapi.ai/v1 و key_env بالقيمة RUNAPI_API_KEY. بمجرد الإعداد، يتعامل نفس المزود مع استدعاءات Luma modify_video إلى جانب الدردشة وطلبات نماذج RunAPI الأخرى.

### هل Luma modify_video متزامن أم غير متزامن؟

غير متزامن. تُعيد نقطة نهاية الإنشاء task_id فوراً. استطلع نقطة نهاية حالة المهمة أو وفِّر callback_url لاستقبال Webhook عند جهوزية الفيديو المعدَّل. يستغرق وقت المعالجة النموذجي من 30 إلى 120 ثانية.

### كم تكلف عملية تعديل الفيديو باستخدام Luma على RunAPI؟

يستخدم Luma الفوترة الثابتة لكل مهمة — كل استدعاء modify_video يكلف مبلغاً ثابتاً بصرف النظر عن مدة الفيديو. راجع صفحة أسعار RunAPI للاطلاع على الأسعار الحالية. لا يُحاسَب على الأجيال الفاشلة.

### هل يمكن لـ Hermes Agent ربط Luma بنماذج توليد الفيديو في سير عمل واحد؟

نعم. يمكن لسير عمل Hermes Agent توليد فيديو باستخدام Kling أو Wan، ثم تمرير رابط الناتج كـ source_video_url إلى Luma modify_video لإعادة التصيير الجوي — كل ذلك من خلال نفس مزود custom:runapi و RUNAPI_API_KEY. تستخدم كل خطوة نفس نمط الاستطلاع غير المتزامن.


## Links

- [دليل إعداد Hermes Agent →](https://runapi.ai/ar/hermes-agent)
- [نماذج Luma →](https://runapi.ai/ar/models/luma)
- [Model catalog](https://runapi.ai/ar/models)
- [API docs](https://runapi.ai/ar/docs)