استخدم Hailuo في Hermes Agent.
Hailuo هو نموذج توليد الفيديو من MiniMax، يُنتج لقطات بدقة 1080p أصلية مع محاكاة فيزيائية دقيقة عبر 6 إصدارات — Hailuo 02 و2.3، لكل منهما نقاط نهاية تحويل النص إلى فيديو والصورة إلى فيديو في مستويَي pro وstandard. يستدعيه Hermes Agent عبر RunAPI باستخدام مزوّد custom:runapi — المفتاح ورابط القاعدة نفسهما اللذان هيّأتهما للمحادثة.
Use RunAPI to generate a video with MiniMax Hailuo 02 Pro through Hermes Agent.
Requirements:
- Use the custom:runapi provider already configured in Hermes Agent
- Call the RunAPI text_to_video endpoint at https://runapi.ai/api/v1/hailuo/text_to_video
- Set model to "hailuo-02-text-to-video-pro"
- The RUNAPI_API_KEY environment variable provides authorization
- Include a detailed prompt describing camera movement and scene
- The response is async — poll the task status endpoint until the task completes, then retrieve the video URL
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."
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "hailuo-02-text-to-video-pro"
}
استخدم Hailuo في Hermes Agent في ثلاث خطوات
تهيئة RunAPI
عيّن متغير البيئة RUNAPI_API_KEY. إذا كنت قد أضفت RunAPI بالفعل كمزوّد custom:runapi في Hermes Agent للمحادثة، فإن المفتاح وbase_url نفسهما يعملان لتوليد الفيديو — دون الحاجة إلى أي إعداد إضافي.
export RUNAPI_API_KEY=runapi_xxx
استدعاء 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 للحفاظ على موضوعك المصدر.
POST /api/v1/hailuo/text_to_video
استطلاع النتيجة
تُعيد نقطة النهاية task_id فورًا. استطلع نقطة نهاية حالة المهمة حتى تتغير الحالة إلى completed، ثم استرجع رابط الفيديو المُولَّد من الاستجابة. يستغرق التحويل عادةً أقل من دقيقتين للمستوى pro.
GET /api/v1/hailuo/text_to_video/tsk_abc123
معاملات Hailuo API
| المعامل | النوع | الوصف |
|---|---|---|
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 عند اكتمال المهمة. |
ما هو Hailuo في Hermes Agent؟
يُقدم Hailuo من MiniMax أسرع سرعة توليد في فئته باتساق حركي سلس واحتفاظ قوي بالتفاصيل. عبر الموفر custom:runapi في Hermes Agent، ينتج لقطات 1080p أصلية من النص أو الصور، ويضيف Hailuo 2.3 أساليب عرض مخصصة للأنمي والتوضيح.
حالات استخدام Hailuo
محتوى قنوات YouTube بدون وجه
أنتج لقطات تأسيسية وتسلسلات مرئية لقنوات المحتوى بدون وجه دون معدات تصوير.
مقاطع المنتجات والتجارة الإلكترونية
أنشئ مقاطع فيديو عرض المنتجات بفيزياء واقعية — سوائل وأقمشة وانعكاسات.
لقطات تأسيسية وB-roll
أنتج لقطات خلفية ومقاطع انتقالية لمشاريع الإنتاج الأطول.
أسئلة حول Hailuo + Hermes Agent
نعم. هيّئ RunAPI كمزوّد custom:runapi في Hermes Agent، ثم استدعِ نقطة نهاية text_to_video أو image_to_video باستخدام slug نموذج Hailuo. يتولى RUNAPI_API_KEY نفسه الذي تستخدمه للمحادثة توليد الفيديو.
يدعم Hailuo 02 تحويل النص إلى فيديو والصورة إلى فيديو مع التحكم في الإطار الأول والأخير. أما Hailuo 2.3 فهو مخصص لتحويل الصورة إلى فيديو فقط، لكنه يضيف حركة جسم محسّنة والتعابير الدقيقة وأنماط عرض مخصصة للأنيمي والرسوم التوضيحية.
يتفاوت تسعير مستوى standard بحسب duration_seconds. لـ text-to-video standard، يكلّف مقطع 6 ثوانٍ 30 سنتًا ومقطع 10 ثوانٍ 50 سنتًا. يأخذ تسعير image-to-video standard في الاعتبار output_resolution أيضًا — يبدأ مقطع 6s 512p من 12 سنتًا.
لا. Hailuo غير متزامن — تُعيد الواجهة البرمجية task_id فورًا. يحتاج سير عمل Hermes Agent إلى استطلاع نقطة نهاية حالة المهمة أو توفير callback_url. يستغرق التوليد عادةً 60-120 ثانية.
فقط على نقاط نهاية Hailuo 02 image-to-video. مرّر first_frame_image_url وlast_frame_image_url معًا لتحديد إطار البداية والنهاية. يقبل Hailuo 2.3 image-to-video first_frame_image_url فقط.
إعداد Hermes Agent العام
لم تُهيّئه بعد؟ ابدأ بدليل إعداد RunAPI لـ Hermes Agent.
دليل إعداد Hermes Agent →كتالوج نماذج Hailuo
اطّلع على جميع إصدارات Hailuo ومستويات التسعير وتوثيق الواجهة البرمجية.
نماذج Hailuo →جرّب Hailuo في Hermes Agent اليوم.
احصل على مفتاح RunAPI مجاني، هيّئ مزوّد custom:runapi، وابدأ توليد الفيديو باستخدام MiniMax Hailuo.