Skip to main content
POST
cURL
استخدم نقطة النهاية هذه لتحريك صورة مصدر واحدة إلى فيديو من Runway.

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

  • أرسل ترويسة X-Runway-Version المطلوبة، على سبيل المثال 2024-11-06
  • استخدم model: gen3a_turbo
  • وفّر promptImage ثابتًا عبر HTTPS
  • ابدأ بـ duration: 5 وقيمة ratio مدعومة للنموذج/الإصدار المحدد من Runway

Duration و ratio

تستخدم الطلبات ذات التنسيق الرسمي في Runway الحقل ratio وليس size. اقرأ قيم ratio بنمط الدقة على أنها مكافئ WxH لها: تستهدف 1280:720 الدقة 1280x720، وتستهدف 720:1280 الدقة 720x1280، ويمكن أن يتم عرض 1280:768 أيضًا على شكل 1280x720 بحسب النموذج/الإصدار المحدد.

تدفق المهمة

1

أرسل طلب تحويل الصورة إلى فيديو

أنشئ المهمة باستخدام صورة مصدر و Prompt حركة قصير اختياري.
2

خزّن id المُعاد

احفظ id الخاص بالمهمة لاستخدامه لاحقًا في polling.
3

استطلع حالة المهمة

استخدم الحصول على مهمة Runway. إذا أعاد أول polling القيمة task_not_exist، فانتظر بضع ثوانٍ ثم أعد المحاولة.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الترويسات

X-Runway-Version
string
مطلوب

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

الجسم

application/json
promptImage
string
افتراضي:https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg
مطلوب

Source image URL.

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

Runway image-to-video model ID. Choose an available model from the Models page.

seed
integer

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

promptText
string

Text prompt describing the desired motion or scene. Maximum 512 characters.

watermark
boolean
افتراضي:false

Whether to add a watermark to the output video.

duration
integer
افتراضي:5

Video duration in seconds. Runway support is model/version dependent; use 5 or 10 for the broadest compatibility. CometAPI forwards this value to Runway.

ratio
string
افتراضي:1280:768

Requested output ratio. Accepted values are Runway model/version dependent. With X-Runway-Version 2024-11-06, use a resolution-style value accepted by the selected model, such as 1280:768, 768:1280, 1280:720, or 720:1280. Read these as WxH targets, but completed media may normalize, so inspect the returned file before relying on exact pixels.

الاستجابة

200 - application/json

Task accepted.

id
string
مطلوب