跳转到主要内容
POST
/
runway
/
feed
Poll a Runway compatibility-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 兼容格式任务后，请使用此端点。它是 /runway/pro/* 工作流的主要轮询步骤。

​
先检查这些字段

  • 顶层状态的 code 和 message
  • 任务进度的 data.status 和 data.progress
  • 提供方侧任务元数据中的嵌套 data.data
  • 任务完成时的最终资源字段，例如 video_url、poster 或相关提供方输出

​
轮询模式

1

先创建兼容格式任务

从兼容格式的 Runway 页面开始，例如 生成、图生视频、视频转视频风格重绘 或 Act-one 表情迁移。
2

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

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

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

持续检查此端点，直到任务离开排队或进行中状态，并且提供方元数据中包含可用的输出 URL。

授权

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

​
code
string | null
必填
​
message
string
必填
​
data
object