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

# استخدم Luma في OpenClaw.

يُعدِّل Luma Ray 3.2 مقاطع الفيديو الموجودة بتحولات مدفوعة بالمطالبات النصية تحافظ على التماسك المكاني وبنية المشهد ثلاثية الأبعاد. أرسل رابط فيديو مصدر ومطالبة نصية تصف التحويل المطلوب — يُعيد Luma تصيير اللقطات مع إضاءة جوية وتفاصيل بيئية وحركة كاميرا متسقة فيزيائياً. يستدعيها وكلاء OpenClaw من خلال نفس مفتاح 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 في بيئتك. إذا كنت قد هيّأت RunAPI للدردشة في OpenClaw، فإن نفس المفتاح يعمل لتعديل الفيديو باستخدام Luma — لا تحتاج إلى إعداد مزود إضافي.
2. **استدعِ Luma modify_video** — أرسل طلب POST إلى نقطة نهاية modify_video مع تعيين النموذج إلى luma-modify-video، وإشارة source_video_url إلى لقطاتك المصدر، ومطالبة تصف التحويل المطلوب. يحافظ Luma على هندسة المشهد الأصلية أثناء تطبيق التغييرات المطلوبة.
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 تصيير اللقطات الموجودة بتغييرات مدفوعة بالمطالبات — تحولات جوية (ضباب، مطر، ساعة ذهبية)، ونقل الأساليب (سينمائي، أنيمي، نوار)، وتجديد الإضاءة، والتحولات البيئية. يحافظ على حركة الكاميرا الأصلية والتخطيط المكاني للمشهد.

### كيف يختلف Luma عن نماذج الفيديو الأخرى على RunAPI؟

يتخصص Luma في تعديل الفيديو الموجود بدلاً من التوليد من الصفر. يحافظ نموذج Ray 3.2 على التماسك المكاني ثلاثي الأبعاد خلال التحولات، بحيث تحتفظ الكائنات بعلاقات العمق وتبقى حركة الكاميرا متسقة فيزيائياً. نماذج مثل Kling أو Hailuo تُولِّد فيديو جديداً من نص أو صور.

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

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

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

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

### هل يمكنني ربط Luma بنماذج فيديو RunAPI الأخرى في سير عمل وكيل واحد؟

نعم. يمكن لوكيل OpenClaw توليد فيديو باستخدام Kling أو Hailuo، ثم تمرير رابط الناتج كـ source_video_url إلى Luma modify_video للمعالجة اللاحقة — كل ذلك من خلال نفس RUNAPI_API_KEY. تستخدم كل خطوة نفس نمط الاستطلاع غير المتزامن.


## Links

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