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

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

Hailuo هو نموذج توليد الفيديو من MiniMax، يُنتج لقطات بدقة 1080p أصلية مع محاكاة فيزيائية دقيقة عبر 6 إصدارات — Hailuo 02 و2.3، لكل منهما نقاط نهاية تحويل النص إلى فيديو والصورة إلى فيديو في مستويَي pro وstandard. تستدعيه عوامل OpenClaw عبر RunAPI باستخدام مفتاح API نفسه المستخدَم في المحادثة.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/hailuo/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-02-text-to-video-pro",
    "prompt": "A glass marble rolls across a wooden desk, catches the edge, and falls in slow motion. Camera follows the marble. Soft window light, shallow depth of field."
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "hailuo-02-text-to-video-pro"
}

```

## How it works

1. **تهيئة RunAPI** — عيّن متغير البيئة RUNAPI_API_KEY. إذا كنت قد هيّأت RunAPI بالفعل كمزوّد لـ OpenClaw في المحادثة، فإن المفتاح نفسه يعمل لتوليد الفيديو — دون الحاجة إلى أي إعداد إضافي.
2. **استدعاء text_to_video أو image_to_video من Hailuo** — أرسل طلب POST إلى /api/v1/hailuo/text_to_video مع ضبط النموذج على hailuo-02-text-to-video-pro ومطالبة تصف المشهد. للفيديو المرتبط بصورة، استخدم نقطة النهاية image_to_video مع first_frame_image_url للحفاظ على موضوعك المصدر.
3. **استطلاع النتيجة** — تُعيد نقطة النهاية task_id فورًا. استطلع نقطة نهاية حالة المهمة حتى تتغير الحالة إلى completed، ثم استرجع رابط الفيديو المُولَّد من الاستجابة. يستغرق التحويل عادةً أقل من دقيقتين للمستوى pro.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | مطلوب. واحد من: hailuo-02-text-to-video-pro, hailuo-02-text-to-video-standard, hailuo-02-image-to-video-pro, hailuo-02-image-to-video-standard, hailuo-2.3-image-to-video-pro, hailuo-2.3-image-to-video-standard. |
| `prompt` | `string` | مطلوب. وصف نصي لمشهد الفيديو وحركة الكاميرا والإضاءة. |
| `first_frame_image_url` | `string` | مطلوب لنقاط نهاية image_to_video. رابط الصورة المصدر المستخدَمة إطارًا أول. |
| `last_frame_image_url` | `string` | اختياري. رابط صورة تُستخدَم إطارًا أخيرًا. متاح على Hailuo 02 image-to-video فقط. |
| `duration_seconds` | `integer` | اختياري. مدة الفيديو بالثواني. القيم المقبولة: 6 أو 10. الافتراضي 10 في standard، ثابت في pro. |
| `output_resolution` | `string` | اختياري. دقة الإخراج. 512p أو 768p لـ 02 standard؛ 768p أو 1080p لإصدارات 2.3. |
| `callback_url` | `string` | اختياري. رابط Webhook يستقبل طلب POST عند اكتمال المهمة. |

## FAQ

### ما الفرق بين Hailuo 02 وHailuo 2.3؟

يدعم Hailuo 02 تحويل النص إلى فيديو والصورة إلى فيديو مع التحكم في الإطار الأول والأخير. أما Hailuo 2.3 فهو مخصص لتحويل الصورة إلى فيديو فقط، لكنه يضيف حركة جسم محسّنة والتعابير الدقيقة وأنماط عرض مخصصة للأنيمي والرسوم التوضيحية غير المتوفرة في 02.

### هل يمكنني ضبط الإطار الأول والأخير للفيديو معًا؟

نعم، لكن فقط على نقاط نهاية Hailuo 02 image-to-video. مرّر first_frame_image_url وlast_frame_image_url معًا. يقبل Hailuo 2.3 image-to-video first_frame_image_url فقط.

### كيف يعمل تسعير pro مقابل standard؟

يكلّف Hailuo 02 Pro text-to-video 57 سنتًا لكل عملية توليد بصرف النظر عن المدة. يستخدم standard التسعير القائم على المدة — 30 سنتًا لـ 6 ثوانٍ، و50 سنتًا لـ 10 ثوانٍ. يأخذ تسعير image-to-video standard في الاعتبار output_resolution أيضًا.

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

غير متزامن. تُعيد الواجهة البرمجية task_id فورًا. استطلع نقطة نهاية حالة المهمة أو عيّن callback_url لتلقي webhook عند جاهزية الفيديو. يستغرق التوليد عادةً 60-120 ثانية.

### ما دقة إخراج Hailuo؟

يُخرج Hailuo 02 Pro دقة 1080p أصلية. يُخرج standard بـ 512p أو 768p حسب معامل output_resolution. تدعم إصدارات Hailuo 2.3 768p أو 1080p. لا يُطبَّق أي تحسين دقة لاحق.


## Links

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