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>'
{
  "id": "d0658ae1-bbdd-4adc-aaba-fd8070e14d79",
  "status": "SUCCEEDED",
  "createdAt": "2026-05-01T12:47:47.351Z",
  "output": [
    "https://example.com/output.mp4"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Sử dụng endpoint này để kiểm tra một tác vụ Runway theo id.

​
Kiểm tra các trường này trước

  • id cho mã định danh tác vụ
  • status cho trạng thái hiện tại của tác vụ
  • output cho các URL tài sản đã hoàn tất khi tác vụ thành công
  • failure và failureCode khi tác vụ thất bại

​
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 định dạng này thay vì route feed theo định dạng tương thích

​
Hành vi thử lại

  • Một tác vụ vừa được tạo có thể tạm thời trả về task_not_exist
  • Đợi vài giây rồi thử lại 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à route feed theo định dạng tương thích có thể trả về cùng một phản hồi đang xếp hàng hoặc đang xử lý

Ủ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 task state.

​
id
string
bắt buộc

Task ID.

​
status
enum<string>
bắt buộc

Task status.

Tùy chọn có sẵn:
PENDING,
RUNNING,
SUCCEEDED,
FAILED
​
createdAt
string

Task creation timestamp.

​
output
string[]

Output URLs returned after the task succeeds.

​
failure
string

Failure reason returned after the task fails.

​
failureCode
string

Failure code returned after the task fails.

​
progress
number

Task progress.