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

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

يُنشئ Runway Gen-4 مقاطع فيديو مدتها 5 أو 10 ثوانٍ بدقة 720p أو 1080p انطلاقًا من وصف نصي أو صورة لإطار البداية. يستدعيها عملاء OpenClaw بنفس مفتاح RunAPI المستخدم للمحادثة — أرسل text_to_video مع المدة والدقة، واستطلع المهمة لتستقبل رابط الفيديو. مدّد المقاطع الحالية بـ extend_video، أو استخدم Runway Aleph لتحرير الفيديو.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/runway/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway",
    "prompt": "A drone shot rising over a misty mountain lake at sunrise, cinematic lighting",
    "duration_seconds": 10,
    "output_resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "runway"
}

```

## How it works

1. **هيّئ RunAPI** — عيّن RUNAPI_API_KEY في بيئتك. إن كنت قد هيّأت RunAPI للمحادثة في OpenClaw مسبقًا، فالمفتاح نفسه يعمل لتوليد فيديو Runway — لا حاجة لإعداد موفّر إضافي.
2. **استدعِ Runway text_to_video** — أرسل طلب POST إلى نقطة نهاية text_to_video مع تعيين model على runway، ووصف نصي، وduration_seconds (5 أو 10)، وoutput_resolution (720p أو 1080p). أضف first_frame_image_url لتثبيت الإطار الافتتاحي على صورة مرجعية.
3. **استطلع النتيجة** — تُعيد نقطة النهاية task_id فورًا. استطلع نقطة نهاية حالة المهمة حتى تصبح الحالة completed، ثم اقرأ رابط الفيديو الناتج من الاستجابة. لتمديد المقطع، استدعِ extend_video مع source_task_id.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | مطلوب. استخدم runway لـ Gen-4، أو runway-aleph لـ Aleph edit_video. |
| `prompt` | `string` | مطلوب. وصف نصي لمحتوى الفيديو — حركة الكاميرا والمشهد والإضاءة. |
| `duration_seconds` | `integer` | مطلوب. مدة الفيديو: 5 أو 10 ثوانٍ. |
| `output_resolution` | `string` | مطلوب. دقة الإخراج: 720p أو 1080p. تؤثر على التسعير. |
| `first_frame_image_url` | `string` | اختياري. رابط صورة تُستخدم كإطار أول للفيديو. |
| `aspect_ratio` | `string` | اختياري. نسبة أبعاد الإخراج: 16:9 أو 9:16 أو 1:1 أو 4:3 أو 3:4. |
| `callback_url` | `string` | اختياري. رابط Webhook يستقبل POST عند اكتمال المهمة. |

## FAQ

### هل يمكنني استخدام توليد فيديو Runway في OpenClaw؟

نعم. يمكن لعملاء OpenClaw استدعاء نقطة نهاية RunAPI لـ Runway مباشرةً. هيّئ RunAPI بـ RUNAPI_API_KEY، ثم أرسل POST إلى /api/v1/runway/text_to_video مع تعيين model على runway، ووصف نصي، ومدة ودقة.

### ما الفرق بين Runway Gen-4 و Runway Aleph؟

يتولى Runway Gen-4 (model: runway) معالجة text_to_video و extend_video. أما Runway Aleph (model: runway-aleph) فيتولى edit_video — تحويل فيديو موجود بوصف نصي. استخدم Gen-4 لإنشاء فيديو جديد من الصفر، وAleph لإعادة تصميم مقاطع موجودة.

### كيف يعمل تسعير Runway على RunAPI؟

يعتمد Runway نظام فوترة مصفوفي استنادًا إلى duration_seconds و output_resolution. مقطع 5 ثوانٍ بدقة 720p أقل تكلفة من مقطع 10 ثوانٍ بدقة 1080p. راجع صفحة تسعير RunAPI للأسعار الحالية. فوترة بالثانية، لا اشتراك مطلوب.

### هل يمكنني تمديد فيديو Runway بعد إنشائه؟

نعم. استدعِ نقطة نهاية extend_video مع source_task_id من التوليد الأصلي ووصف نصي جديد. يُضاف التمديد إلى المقطع الحالي. يُحتسب تسعير التمديد لكل مقطع استنادًا إلى output_resolution.

### هل توليد الفيديو بـ Runway متزامن أم غير متزامن؟

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


## Links

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