Skip to main content
POST
cURL
استخدم نقطة النهاية هذه لتحويل مقطع مصدر موجود باستخدام سير عمل Runway لتحويل الفيديو إلى فيديو. وهي تبدأ مهمة غير متزامنة بدلًا من إرجاع الناتج النهائي فورًا.

قبل استدعائها

  • جهّز فيديو مصدرًا يطابق متطلبات الإدخال الخاصة بالمزوّد
  • أدرج ترويسة X-Runway-Version المطلوبة لمجموعة الميزات التي تريدها
  • ابدأ بـ Prompt قصير واحد يصف التغيير، وليس لوحة قصة كاملة

نسبة الإخراج

تتوقع نقطة النهاية هذه قيم ratio مفصولة بنقطتين. استخدم 1280:720 لإخراج 1280x720 و720:1280 لإخراج 720x1280؛ ولا يتم قبول 1280x720 في كل مسارات Runway لتحويل الفيديو إلى فيديو.

تدفق المهمة

1

إرسال المقطع المصدر وPrompt

ابدأ المهمة من نقطة النهاية هذه واحفظ معرّف المهمة المُعاد.
2

الاستعلام عن تفاصيل المهمة

استخدم الحصول على مهمة Runway حتى تصل المهمة إلى حالة نهائية.
3

تخزين النتيجة المُحوّلة

نزّل الأصل المكتمل أو احتفظ به عبر مسار الوسائط المعتاد لديك.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الترويسات

X-Runway-Version
string
مطلوب

Runway API version header, for example 2024-11-06.

الجسم

application/json
videoUri
string
افتراضي:https://your-video-host/source.mp4
مطلوب

HTTPS URL of the source video, or a base64 data URI containing the video.

promptText
string
افتراضي:A cat yawning in slow motion.
مطلوب

Text prompt describing the desired output. Maximum 1000 characters.

seed
integer
افتراضي:1
مطلوب

Random seed for reproducible results. Range: 0–4294967295.

model
string
افتراضي:gen4_aleph
مطلوب

Model variant to use.

references
object[]
مطلوب

Optional reference images to guide generation. Each item must include type (e.g. image) and uri (HTTPS URL).

ratio
string
افتراضي:1280:720
مطلوب

Requested output frame shape. Use colon-separated values such as 1280:720 or 720:1280; read them as 1280x720 and 720x1280 targets. Do not assume every Runway video-to-video route accepts 1280x720 with an x separator.

contentModeration
object
مطلوب

الاستجابة

200 - application/json

success

id
string
مطلوب

The ID of the task that was created. Use this to retrieve the task later.