استخدم Runway في Hermes Agent.
يُنشئ Runway Gen-4 مقاطع فيديو مدتها 5 أو 10 ثوانٍ بدقة 720p أو 1080p انطلاقًا من وصف نصي أو صورة لإطار البداية. يستدعيه Hermes Agent عبر نقطة النهاية المخصصة لـ RunAPI — هيّئ custom:runapi مرة واحدة، أرسل text_to_video مع المدة والدقة، واستطلع للحصول على الفيديو النهائي. مدّد المقاطع بـ extend_video، أو استخدم Runway Aleph لتحرير الفيديو.
Use RunAPI to generate a video with Runway Gen-4.
Requirements:
- Read the API key from RUNAPI_API_KEY.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- Call POST https://runapi.ai/api/v1/runway/text_to_video
- Set model to "runway".
- Set prompt to describe the video content.
- Set duration_seconds to 5 or 10.
- Set output_resolution to "720p" or "1080p".
- Optionally set first_frame_image_url to guide the opening frame.
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the video URL from the response output.
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"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "runway"
}
استخدم Runway في Hermes Agent في ثلاث خطوات
هيّئ RunAPI
عيّن RUNAPI_API_KEY في البيئة التي يعمل فيها Hermes Agent. إن كنت قد أضفت RunAPI كموفّر custom:runapi مسبقًا، فالمفتاح نفسه يتولى طلبات فيديو Runway — لا حاجة لإعداد موفّر إضافي.
export RUNAPI_API_KEY=runapi_xxx
استدعِ 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 لتثبيت الإطار الافتتاحي.
POST /api/v1/runway/text_to_video
استطلع النتيجة
تُعيد نقطة النهاية task_id فورًا. استطلع نقطة نهاية حالة المهمة حتى تصبح الحالة completed، ثم اقرأ رابط الفيديو الناتج من الاستجابة. لتمديد المقطع، استدعِ extend_video مع source_task_id.
GET /api/v1/runway/text_to_video/tsk_abc123
معاملات واجهة برمجة Runway text_to_video
| المعامل | النوع | الوصف |
|---|---|---|
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 عند اكتمال المهمة. |
ما هو Runway في Hermes Agent؟
يُقدم Runway Gen-4 فيديو بمستوى الإنتاج مع تأطير سينمائي وحركة سلسة. عبر الموفر custom:runapi في Hermes Agent، يمكنك ربط النص إلى الفيديو والصورة إلى الفيديو بنماذج RunAPI الأخرى لخطوط أنابيب محتوى متكاملة.
حالات استخدام Runway
محتوى سردي بشخصيات متسقة
ابنِ تسلسلات فيديو متعددة اللقطات حيث تحافظ الشخصيات على هويتها المرئية بين المقاطع.
إنتاج الإعلانات والمحتوى الاجتماعي
أنتج Instagram Reels ومقاطع TikTok وإعلانات مصغّرة على نطاق واسع للحملات التسويقية.
إعادة تصميم الفيديو بـ Aleph
حوّل اللقطات الموجودة بـ Runway Aleph — غيّر الأسلوب المرئي أو المزاج أو الجماليات.
أسئلة حول Runway + Hermes Agent
نعم. يمكن لـ Hermes Agent استدعاء نقطة نهاية RunAPI لـ Runway عبر موفّر custom:runapi. عيّن RUNAPI_API_KEY في بيئتك وأرسل POST إلى /api/v1/runway/text_to_video مع تعيين model على runway، ووصف نصي، ومدة ودقة.
يتولى Runway Gen-4 (model: runway) معالجة text_to_video و extend_video — إنشاء مقاطع جديدة من نص أو صور. أما Runway Aleph (model: runway-aleph) فيتولى edit_video — إعادة تصميم مقاطع موجودة بوصف نصي و source_video_url. كلاهما يعمل عبر نفس مفتاح RunAPI.
يعتمد Runway نظام فوترة مصفوفي استنادًا إلى duration_seconds و output_resolution. مقطع 5 ثوانٍ بدقة 720p أقل تكلفة من مقطع 10 ثوانٍ بدقة 1080p. راجع صفحة تسعير RunAPI للأسعار الحالية. فوترة بالثانية، لا اشتراك مطلوب.
نعم. عيّن first_frame_image_url على رابط صورة مرجعية إلى جانب وصفك النصي. يستخدم Runway Gen-4 تلك الصورة كإطار افتتاحي ويُحرّكها وفق وصفك. يمنحك ذلك تحكمًا دقيقًا في تركيبة البداية.
غير متزامن. تُعيد نقطة نهاية الإنشاء task_id فورًا. يستغرق توليد الفيديو عادةً 30 إلى 120 ثانية حسب المدة والدقة. استطلع نقطة نهاية حالة المهمة أو أدرج callback_url لاستقبال Webhook عند جهوزية الفيديو.
إعداد Hermes Agent العام
لم تُهيّئه بعد؟ ابدأ بدليل إعداد RunAPI لـ Hermes Agent.
دليل إعداد Hermes Agent →كتالوج نماذج Runway
اطّلع على نسخ Runway Gen-4 وAleph والتسعير ووثائق واجهة برمجة التطبيقات.
نماذج Runway →جرّب Runway في Hermes Agent اليوم.
احصل على مفتاح RunAPI مجاني، هيّئ موفّر custom:runapi، وأنشئ فيديو سينمائي بـ Runway Gen-4 بدقة 720p أو 1080p.