跳转到主要内容
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/* 工作流的主要轮询步骤。

先检查这些字段

  • 外层的 codemessage,用于判断包装层状态
  • data.statusdata.progress,用于查看任务进度
  • 嵌套的 data.data,用于查看提供方侧的任务元数据
  • 任务完成时的最终资源字段,例如 video_urlposter 或相关提供方输出

轮询模式

1

先创建 reverse-format 任务

先从一个 reverse-format 的 Runway 页面开始,例如 生成图生视频视频转视频风格重绘Act-one 表情迁移
2

如果任务暂时不可见,重试一次

新的任务 id 可能会短暂返回 task_not_exist。如果发生这种情况,请等待几秒后再次轮询。
3

持续轮询,直到任务进入终态

持续检查此端点,直到包装层状态离开排队或进行中状态,并且提供方元数据中包含可用的输出 URL。
在 2026-03-13 的实时验证中确认,一个新的 Runway 任务 id 在短暂延迟后首次通过此端点可见,随后返回了一个包装后的 payload,其中 code: successdata.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