المواصفات التقنية لـ runwayml-image-to-video
| المواصفات | التفاصيل |
|---|---|
| معرّف النموذج | runwayml-image-to-video |
| المزوّد | Runway |
| القدرة الأساسية | يولّد فيديو من صورة بداية باستخدام مُحفّز نصّي وتوليد حركة مشروط بالصورة. |
| نوع مهمة واجهة برمجة التطبيقات | مهمة توليد تحويل الصورة إلى فيديو غير متزامنة تُبدأ عبر نقطة النهاية لتحويل الصورة إلى فيديو لدى Runway. |
| النماذج الأساسية المدعومة في واجهة Runway | تقبل نقطة النهاية لتحويل الصورة إلى فيديو لدى Runway عدة نماذج فيديو، بما في ذلك gen4_turbo وgen3a_turbo وveo3.1 وveo3.1_fast وveo3. |
| المدخلات المطلوبة | صورة إدخال إضافةً إلى معلمات توليد خاصة بالنموذج؛ ويُستخدم النص المُحفِّز عادةً لوصف الحركة المرغوبة وسلوك المشهد. |
| المصادقة | مفتاح API بنظام Bearer في ترويسة Authorization. |
| ترويسة الإصدار | يتطلب مرجع واجهة برمجة التطبيقات لدى Runway ترويسة X-Runway-Version، بالقيمة الموثقة 2024-11-06 لنقطة نهاية تحويل الصورة إلى فيديو. |
| صيغة المخرجات | أصل فيديو مُولَّد يُعاد عبر معالجة قائمة على المهام. |
| معدل الإطارات النموذجي | يذكر توثيق Runway معدل 24 fps لمخرجات تحويل الصورة إلى فيديو في Gen-3 Alpha. |
| الدقة الشائعة للمخرجات | توثّق Runway دقة 1280×768 لـ Gen-3 Alpha وكلًا من 1280×768 و768×1280 لـ Gen-3 Alpha Turbo، بحسب الاتجاه. |
| إرشادات إدخال الصورة | توصي Runway بتجنب صور المرجع الأصغر من 640×640 px أو الأكبر من 4K لمدخلات الصور. |
| نمط الاستخدام على CometAPI | يتم الوصول إليه عبر CometAPI باستخدام معرّف نموذج المنصة runwayml-image-to-video. |
ما هو runwayml-image-to-video؟
runwayml-image-to-video هو معرّف نموذج CometAPI للوصول إلى قدرة Runway على توليد تحويل الصورة إلى فيديو. عمليًا، يأخذ هذا النوع من النماذج صورة ثابتة كنقطة انطلاق بصرية ويحوّلها إلى فيديو مُولّد، عادةً بإرشاد من نص مُحفِّز يصف الحركة وسلوك الكاميرا والأجواء أو تطوّر المشهد.
تضع Runway تحويل الصورة إلى فيديو كجزء من حزمة توليد الفيديو الأوسع لديها. يصف توثيق Gen-3 Alpha تحويل الصورة إلى فيديو بوصفه طريقة لتحريك الصورة المُقدَّمة، مع تركيز التوجيه النصّي على الحركة على وجه الخصوص بدلاً من إعادة وصف كل ما يظهر بالفعل في الإطار.
ومن منظور واجهة برمجة التطبيقات، تُقدّم Runway توليد تحويل الصورة إلى فيديو عبر نقطة نهاية لإنشاء المهام، ما يعني أن الطلبات تبدأ عادةً مهمة أولاً ثم تتطلب الاستطلاع أو خطوات الاسترجاع للحصول على نتيجة الفيديو النهائية بعد اكتمال المعالجة.
الميزات الرئيسية لـ runwayml-image-to-video
- توليد فيديو مشروط بالصورة: يبدأ من صورة ثابتة ويولّد مخرجات فيديو مدفوعة بالحركة بدلاً من إنشاء فيديو من النص فقط.
- تحكم بالحركة موجّه بالمحفّز: يعمل على نحو أفضل عندما تصف المطالبات الحركة وحركة الكاميرا وتغيّرات المشهد لتحريك الإطار المزوَّد بشكل مترابط.
- سير عمل مهام غير متزامن: يستخدم طلب بدء التوليد متبوعًا باسترجاع النتائج، وهو ما يلائم الأنظمة الإنتاجية التي تصفّ وتراقب مهام الوسائط طويلة الأمد.
- خيارات متعددة للنماذج الخلفية: تدعم نقطة نهاية Runway لتحويل الصورة إلى فيديو عدة نماذج فيديو، ما يمنح المطوّرين مرونة بين الجودة والسرعة وتكاليف التشغيل.
- مصادقة API بأسلوب إنتاجي: تستخدم مصادقة رمز Bearer القياسي وترويسات إصدار صريحة لتكاملات مضبوطة.
- دعم المخرجات العمودية والأفقية: توثّق Runway أحجام مخرجات لكلٍ من أوضاع العرض الأفقي والعمودي في عائلات النماذج المدعومة.
- توافق مع سير عمل صور المرجع: صُمّمت الواجهة حول صور مرجعية، وتقدّم Runway توصيات لحجم الإدخال للمحافظة على جودة التوليد.
- ملاءمة لأنابيب العمل الإبداعية القابلة للتوسّع: تتضمن منصة Runway سير عمل مرتبطًا بتوليد الفيديو مثل الإطارات المفتاحية والتوسيع وأوضاع توليد أخرى، ما يجعل تحويل الصورة إلى فيديو مرحلة مفيدة ضمن خط إبداعي أكبر.
كيفية الوصول إلى ودمج runwayml-image-to-video
الخطوة 1: التسجيل للحصول على مفتاح واجهة برمجة التطبيقات
للبدء، سجّل في CometAPI وأنشئ مفتاح واجهة برمجة التطبيقات من لوحة التحكم. بعد الحصول على مفتاحك، خزّنه بأمان واستخدمه في ترويسة Authorization لجميع الطلبات.
الخطوة 2: إرسال طلبات إلى واجهة runwayml-image-to-video
استخدم صيغة واجهة Runway الرسمية عبر CometAPI. نقطة النهاية هي POST /runwayml/v1/image_to_video. تضمّن ترويسة X-Runway-Version.
curl https://api.cometapi.com/runwayml/v1/image_to_video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-H "X-Runway-Version: 2024-11-06" \
-d '{
"model": "gen4_aleph",
"promptText": "Your prompt here."
}'
الخطوة 3: استرجاع النتائج والتحقق منها
تعيد الواجهة كائن مهمة يحتوي على معرّف مهمة. نفّذ استطلاعًا باستخدام GET /runwayml/v1/tasks/{task_id} للتحقق من حالة التوليد، ثم استرجع رابط المخرج من استجابة المهمة المكتملة.