الانتقال إلى المحتوى الرئيسي
POST
/
runwayml
/
v1
/
video_upscale
Create a Runway video-upscale task
curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/video_upscale \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "videoUri": "https://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4",
  "model": "upscale_v1"
}
'
{
  "id": "<string>"
}
استخدم نقطة النهاية هذه لبدء مهمة ترقية دقة في Runway لأصل فيديو موجود.

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

  • أرسل ترويسة X-Runway-Version المطلوبة، على سبيل المثال 2024-11-06
  • استخدم model: upscale_v1
  • وفّر videoUri ثابتًا عبر HTTPS
  • توقّع ترقية دقة بمقدار 4x مع حد أقصى لطول الحافة يبلغ 4096 بكسل

تدفق المهمة

1

إرسال فيديو المصدر

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

تخزين معرّف المهمة

احفظ id المُعاد لاستخدامه لاحقًا في التحقق من الحالة.
3

الاستعلام حتى الاكتمال

استخدم Get Task Details حتى تنتهي المهمة ويكشف metadata الخاص بالمزوّد عن المخرجات النهائية.

متى تستخدمها

  • بعد اعتماد التصيير النهائي للتحرير
  • عندما تحتاج إلى أصل تسليم بدقة أعلى بدلًا من معاينة أسرع

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الترويسات

X-Runway-Version
string
مطلوب

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

الجسم

application/json
videoUri
string
افتراضي:https://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4
مطلوب

A HTTPS URL pointing to a video or a data URI containing a video.

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

The model variant to use. Must be upscale_v1.

الاستجابة

200 - application/json

Task accepted.

id
string
مطلوب