الانتقال إلى المحتوى الرئيسي
GET
/
runwayml
/
v1
/
tasks
/
{id}
Poll a Runway official-format task
curl --request GET \
  --url https://api.cometapi.com/runwayml/v1/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "3d957031-9a2a-45e2-9dc7-bc8513059c50",
    "action": "IMAGE_TO_VIDEO",
    "status": "QUEUED",
    "fail_reason": "",
    "submit_time": 1773366766,
    "start_time": 0,
    "finish_time": 0,
    "progress": "0%",
    "data": {
      "id": "3d957031-9a2a-45e2-9dc7-bc8513059c50",
      "status": "PENDING",
      "createdAt": "2026-03-13T09:52:46+08:00"
    }
  }
}
استخدم نقطة النهاية هذه لفحص مهمة Runway حسب المعرّف من خلال الغلاف ذي التنسيق الرسمي.

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

  • code وmessage الخارجيان لحالة الغلاف
  • data.status وdata.progress لحالة المهمة الحالية
  • data.data المتداخلة للبيانات الوصفية الخاصة بالمهمة لدى المزوّد

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

  • بعد استدعاء صفحة إنشاء مهمة Runway بالتنسيق الرسمي مثل text-to-image أو image-to-video أو video-to-video أو upscale
  • عندما تحتاج إلى استجابة الغلاف الموحّدة بدلًا من مسار feed ذي التنسيق العكسي

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

  • قد تُرجع المهمة التي أُنشئت حديثًا task_not_exist لفترة وجيزة
  • انتظر بضع ثوانٍ ثم أعد المحاولة قبل اعتبار معرّف المهمة غير صالح
  • بمجرد أن تصبح المهمة مرئية، يمكن لهذا المسار وغلاف feed العكسي أن يُرجعا نفس الغلاف للحالة قيد الانتظار أو قيد التنفيذ
أعادت عملية التحقق المباشر في 2026-03-13 استجابة مغلّفة تحتوي على code: success وstatus: QUEUED وعنصر data متداخل بدلًا من كائن مهمة Runway مجرد.

التفويضات

​
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 wrapper task state or not-yet-visible error.

​
code
string | null
مطلوب
​
message
string
مطلوب
​
data
object