Skip to main content
POST
cURL
Sử dụng endpoint này để tạo chuyển động cho một ảnh nguồn thành video Runway.

Trước khi gọi

  • Gửi header X-Runway-Version bắt buộc, ví dụ 2024-11-06
  • Sử dụng model: gen3a_turbo
  • Cung cấp promptImage HTTPS ổn định
  • Bắt đầu với duration: 5 và một giá trị ratio được hỗ trợ cho model/phiên bản Runway đã chọn

Duration và ratio

Các request theo định dạng chính thức của Runway sử dụng ratio, không phải size. Hãy hiểu các giá trị ratio kiểu độ phân giải theo dạng tương đương WxH của chúng: 1280:720 nhắm tới 1280x720, 720:1280 nhắm tới 720x1280, và 1280:768 vẫn có thể render thành 1280x720 tùy thuộc vào model/phiên bản đã chọn.

Luồng tác vụ

1

Gửi request image-to-video

Tạo tác vụ với một ảnh nguồn và một motion prompt ngắn tùy chọn.
2

Lưu id được trả về

Lưu id của tác vụ để polling sau.
3

Poll trạng thái tác vụ

Sử dụng Lấy một tác vụ Runway. Nếu lần poll đầu tiên trả về task_not_exist, hãy đợi vài giây rồi thử lại.

Ủy quyền

Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Tiêu đề

X-Runway-Version
string
bắt buộc

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

Nội dung

application/json
promptImage
string
mặc định:https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg
bắt buộc

Source image URL.

model
string
mặc định:gen3a_turbo
bắt buộc

Runway image-to-video model ID. Choose an available model from the Models page.

seed
integer

Random seed for reproducible results. Range: 0–999999999.

promptText
string

Text prompt describing the desired motion or scene. Maximum 512 characters.

watermark
boolean
mặc định:false

Whether to add a watermark to the output video.

duration
integer
mặc định:5

Video duration in seconds. Runway support is model/version dependent; use 5 or 10 for the broadest compatibility. CometAPI forwards this value to Runway.

ratio
string
mặc định:1280:768

Requested output ratio. Accepted values are Runway model/version dependent. With X-Runway-Version 2024-11-06, use a resolution-style value accepted by the selected model, such as 1280:768, 768:1280, 1280:720, or 720:1280. Read these as WxH targets, but completed media may normalize, so inspect the returned file before relying on exact pixels.

Phản hồi

200 - application/json

Task accepted.

id
string
bắt buộc