runway_video

المواصفات التقنية لـ runway-video

ما هو runway-video؟

runway-video هو مُعرّف المنصة لدى CometAPI للوصول إلى قدرات توليد الفيديو الخاصة بـ Runway عبر واجهة برمجة موحّدة. استناداً إلى وثائق واجهة برمجة التطبيقات الرسمية لـ Runway، تُقدّم Runway عدة نماذج فيديو لتوليد المقاطع من مطالبات نصية أو من صور، مع نقاط نهاية قائمة على المهام لبدء عمليات التوليد ثم استرجاع النتائج لاحقاً.

عملياً، يُفهم runway-video على أنه بوابة إلى سير عمل إنشاء الفيديو المدعوم بـ Runway، وليس اسماً لنموذج أساسي منفرد قائم بذاته. يتضمن كتالوج واجهة برمجة التطبيقات الحالي لـ Runway عدة نماذج فيديو بطرق إدخال وفئات تسعير مختلفة، مثل gen4.5 لتحويل النص أو الصورة إلى فيديو، وgen4_turbo لتحويل الصورة إلى فيديو، إضافةً إلى خيارات أخرى مثل gen4_aleph وveo3 وveo3.1 وveo3.1_fast وgen3a_turbo.

يجعل ذلك runway-video مناسباً لتطبيقات مثل النمذجة الإبداعية الأولية، وتوليد محتوى التسويق، وإنتاج مقاطع وسائل التواصل الاجتماعي، وتصوير المفاهيم، وتجارب المنتجات التي تتطلب توليد مقاطع فيديو قصيرة مؤتمتة. ونظراً لأن واجهة Runway الأساسية تستخدم مهام غير متزامنة، فعادةً ما ترسل عمليات التكامل طلب توليد أولاً ثم تقوم بالاستطلاع أو استرجاع مخرجات المهمة عند انتهاء المعالجة.

الميزات الرئيسية لـ runway-video

• توليد من نص إلى فيديو: تدعم Runway إنشاء الفيديو من مطالبات باللغة الطبيعية على النماذج المدعومة، ما يمكّن المطورين من توليد مقاطع مباشرةً من أوصاف نصية.
• سير عمل من صورة إلى فيديو: تقبل عدة نماذج فيديو من Runway مدخلات على شكل صور، ما يجعل runway-video مفيداً لتحريك الصور الثابتة أو بناء خطوط توليد فيديو تستند إلى مراجع.
• خيارات متعددة للنماذج الأساسية: تُظهر واجهة Runway عدة نماذج فيديو بقدرات وتكاليف مختلفة، ما يمنح المطورين مرونة لتحسين الجودة أو السرعة أو الميزانية.
• معالجة مهام غير متزامنة: تُنشئ طلبات التوليد مهاماً بدلاً من إعادة الوسائط النهائية فوراً، وهو ما يلائم الأنظمة الإنتاجية التي تحتاج إلى طوابير ومحاولات إعادة وفحوصات حالة.
• رفع أصول مؤقت: توفّر Runway نقاط رفع تُعيد مراجع runwayUri، ما يُسهّل تمرير الصور أو الفيديو أو الصوت إلى طلبات التوليد اللاحقة.
• دعم حِزم SDK الرسمية: توفّر Runway حِزماً لـ Node.js وPython، ما يُبسّط المصادقة وبناء الطلبات واسترجاع المخرجات.
• تكامل بواجهة مميزة بإصدار: تتطلب الطلبات رأساً صريحاً X-Runway-Version، ما يساعد المطورين على البناء وفق عقد واجهة معروف.
• تسعير قائم على الاعتمادات: تُحاسِب Runway توليد الفيديو بالاعتمادات لكل ثانية، مع تباين الأسعار بحسب النموذج المختار.

كيفية الوصول إلى runway-video ودمجه

الخطوة 1: التسجيل للحصول على مفتاح API

للوصول إلى runway-video، أنشئ حساباً ثم ولّد مفتاح API عبر لوحة تحكم CometAPI. بعد تسجيل الدخول، انسخ مفتاحك وخزّنه بأمان في متغير بيئي أو مدير أسرار للاستخدام الإنتاجي.

الخطوة 2: إرسال الطلبات إلى واجهة runway-video

استخدم مفتاح API الخاص بك لمصادقة الطلبات إلى نقطة نهاية CometAPI الخاصة بـ runway-video. مرّر مطالبتك وأي معلمات إدخال مدعومة في هيكل الطلب، وعيّن النموذج إلى runway-video.

curl -X POST "https://api.cometapi.com/v1/responses" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway-video",
    "input": "Create a cinematic video of a futuristic city at sunrise with slow camera movement."
  }'

الخطوة 3: استرجاع النتائج والتحقق منها

بعد الإرسال، افحص استجابة واجهة البرمجة للتحقق من المخرجات المُولَّدة، أو معرّف المهمة، أو حمولة النتيجة المُعادة لـ runway-video. إذا كان التوليد يجري بشكل غير متزامن، فقم بالاستطلاع لنقطة نهاية CometAPI ذات الصلة حتى تكتمل المعالجة، ثم تحقّق من عنوان الفيديو المُعاد وبياناته الوصفية ومحتواه قبل استخدامه في تطبيقك.