Skip to main content
GET
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 nguyê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 sử 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 hoặc video-to-video

​
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
  • Chờ vài giây và thử lại trước khi coi id tác vụ là không hợp lệ
  • Khi tác vụ đã hiển thị, tiếp tục polling endpoint này cho đến khi nó trả về trạng thái kết thúc hoặc đầu ra hoàn tất.

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