Chuyển đến nội dung chính
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"
    }
  }
}
Sử dụng endpoint này để kiểm tra một tác vụ Runway theo id thông qua wrapper định dạng chính thức.

​
Trước tiên hãy kiểm tra các trường này

  • code và message bên ngoài để biết trạng thái ở cấp wrapper
  • data.status và data.progress để biết trạng thái hiện tại của tác vụ
  • data.data lồng nhau cho metadata tác vụ dành riêng cho provider

​
Khi nào nên dùng

  • Sau khi gọi một trang tạo tác vụ Runway theo định dạng chính thức như text-to-image, image-to-video, video-to-video hoặc upscale
  • Khi bạn cần phản hồi wrapper hợp nhất thay vì route feed theo định dạng ngược

​
Hành vi retry

  • Một tác vụ vừa được tạo có thể tạm thời trả về task_not_exist
  • Hãy đợi vài giây rồi retry trước khi coi id tác vụ là không hợp lệ
  • Khi tác vụ đã hiển thị, route này và wrapper feed ngược có thể trả về cùng một envelope đang chờ xử lý hoặc đang trong tiến trình
Xác thực trực tiếp vào ngày 2026-03-13 đã trả về một phản hồi được bọc với code: success, status: QUEUED, và một đối tượng data lồng nhau thay vì một đối tượng tác vụ Runway thuần.

Ủy quyền

​
Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Tiêu đề

​
X-Runway-Version
string

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

Tham số đường dẫn

​
id
string
bắt buộc

Runway task id returned by the create endpoint.

Phản hồi

200 - application/json

Current wrapper task state or not-yet-visible error.

​
code
string | null
bắt buộc
​
message
string
bắt buộc
​
data
object