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

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

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

## 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 بالفعل كمزوّد custom:runapi في Hermes Agent للمحادثة، فإن المفتاح وbase_url نفسهما يعملان لتوليد الفيديو — دون الحاجة إلى أي إعداد إضافي.
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 في Hermes Agent؟

نعم. هيّئ RunAPI كمزوّد custom:runapi في Hermes Agent، ثم استدعِ نقطة نهاية text_to_video أو image_to_video باستخدام slug نموذج Hailuo. يتولى RUNAPI_API_KEY نفسه الذي تستخدمه للمحادثة توليد الفيديو.

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

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

### كيف يعمل التسعير القائم على المدة في المستويات standard؟

يتفاوت تسعير مستوى standard بحسب duration_seconds. لـ text-to-video standard، يكلّف مقطع 6 ثوانٍ 30 سنتًا ومقطع 10 ثوانٍ 50 سنتًا. يأخذ تسعير image-to-video standard في الاعتبار output_resolution أيضًا — يبدأ مقطع 6s 512p من 12 سنتًا.

### هل يتولى Hermes Agent الاستطلاع غير المتزامن تلقائيًا؟

لا. Hailuo غير متزامن — تُعيد الواجهة البرمجية task_id فورًا. يحتاج سير عمل Hermes Agent إلى استطلاع نقطة نهاية حالة المهمة أو توفير callback_url. يستغرق التوليد عادةً 60-120 ثانية.

### هل يمكنني التحكم في الإطار الأول والأخير لفيديو Hailuo معًا؟

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


## Links

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