الانتقال إلى المحتوى الرئيسي
POST
/
runway
/
feed
Poll a Runway reverse-format task
curl --request POST \
  --url https://api.cometapi.com/runway/feed \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "task_id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}
'
{
  "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 بصيغة reverse-format. وهي خطوة الاستطلاع الرئيسية لسير عمل /runway/pro/*.

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

  • الحقلان الخارجيان code وmessage لمعرفة الحالة على مستوى الغلاف
  • data.status وdata.progress لمعرفة تقدّم المهمة
  • data.data المتداخلة لبيانات وصف المهمة من جهة المزوّد
  • حقول الأصول النهائية مثل video_url وposter أو مخرجات المزوّد ذات الصلة عند اكتمال المهمة

​
نمط الاستطلاع

1

أنشئ مهمة reverse-format أولاً

ابدأ بإحدى صفحات Runway بصيغة reverse-format مثل Generate أو Image-to-Video أو Video to Video Style Redraw أو Act-one Expression Migration.
2

أعد المحاولة مرة واحدة إذا لم تكن المهمة مرئية بعد

قد تُرجع معرّفات المهام الجديدة مؤقتًا task_not_exist. إذا حدث ذلك، فانتظر بضع ثوانٍ ثم أجرِ الاستطلاع مرة أخرى.
3

واصل الاستطلاع حتى تصل المهمة إلى حالة نهائية

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

التفويضات

​
Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الترويسات

​
X-Runway-Version
string

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

الجسم

application/json
​
task_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