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

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

يُنشئ Runway Gen-4 مقاطع فيديو مدتها 5 أو 10 ثوانٍ بدقة 720p أو 1080p انطلاقًا من وصف نصي أو صورة لإطار البداية. يستدعيه Hermes Agent عبر نقطة النهاية المخصصة لـ RunAPI — هيّئ custom: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 في البيئة التي يعمل فيها Hermes Agent. إن كنت قد أضفت RunAPI كموفّر custom:runapi مسبقًا، فالمفتاح نفسه يتولى طلبات فيديو Runway — لا حاجة لإعداد موفّر إضافي.
2. **استدعِ Runway text_to_video** — أرسل طلب POST إلى نقطة نهاية text_to_video مع تعيين model على runway، ووصف نصي، وduration_seconds (5 أو 10)، وoutput_resolution (720p أو 1080p). يمكن لـ Hermes Agent بناء هذا الطلب عبر موفّر custom:runapi. أضف 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 في Hermes Agent؟

نعم. يمكن لـ Hermes Agent استدعاء نقطة نهاية RunAPI لـ Runway عبر موفّر custom: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 — إعادة تصميم مقاطع موجودة بوصف نصي و source_video_url. كلاهما يعمل عبر نفس مفتاح RunAPI.

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

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

### هل يمكنني استخدام first_frame_image_url لتوليد فيديو من صورة؟

نعم. عيّن first_frame_image_url على رابط صورة مرجعية إلى جانب وصفك النصي. يستخدم Runway Gen-4 تلك الصورة كإطار افتتاحي ويُحرّكها وفق وصفك. يمنحك ذلك تحكمًا دقيقًا في تركيبة البداية.

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

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


## Links

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