Skip to main content
GET
استخدم نقطة النهاية هذه لفحص مهمة Runway حسب المعرّف.

​
تحقّق من هذه الحقول أولاً

  • id لمعرّف المهمة
  • status لحالة المهمة الحالية
  • output لعناوين URL الخاصة بالأصل المكتمل عند نجاح المهمة
  • failure و failureCode عند فشل المهمة

​
متى تستخدمها

  • بعد استدعاء صفحة إنشاء مهمة Runway بتنسيق رسمي مثل text-to-image أو image-to-video أو video-to-video

​
سلوك إعادة المحاولة

  • قد تُرجع المهمة التي أُنشئت حديثًا task_not_exist لفترة وجيزة
  • انتظر بضع ثوانٍ وأعد المحاولة قبل اعتبار معرّف المهمة غير صالح
  • بمجرد أن تصبح المهمة مرئية، واصل الاستطلاع لهذه النقطة النهائية حتى تُرجع حالة نهائية أو مخرجًا مكتملًا.

التفويضات

​
Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الترويسات

​
X-Runway-Version
string

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

معلمات المسار

​
id
string
مطلوب

Runway task id returned by the create endpoint.

الاستجابة

200 - application/json

Current task state.

​
id
string
مطلوب

Task ID.

​
status
enum<string>
مطلوب

Task status.

الخيارات المتاحة:
PENDING,
RUNNING,
SUCCEEDED,
FAILED
​
createdAt
string

Task creation timestamp.

​
output
string[]

Output URLs returned after the task succeeds.

​
failure
string

Failure reason returned after the task fails.

​
failureCode
string

Failure code returned after the task fails.

​
progress
number

Task progress.