Skip to main content
POST
cURL
Sử dụng endpoint này để biến đổi một clip nguồn hiện có bằng quy trình video-to-video của Runway. Endpoint này khởi tạo một tác vụ bất đồng bộ thay vì trả về ngay đầu ra cuối cùng.

Trước khi gọi

  • Chuẩn bị một video nguồn phù hợp với các yêu cầu đầu vào của nhà cung cấp
  • Bao gồm header X-Runway-Version bắt buộc cho bộ tính năng bạn muốn dùng
  • Bắt đầu với một prompt ngắn mô tả thay đổi, không phải toàn bộ storyboard

Tỷ lệ đầu ra

Endpoint này yêu cầu các giá trị ratio được phân tách bằng dấu hai chấm. Dùng 1280:720 cho đầu ra 1280x720720:1280 cho 720x1280; 1280x720 không được chấp nhận trên mọi route video-to-video của Runway.

Luồng tác vụ

1

Gửi clip nguồn và prompt

Khởi tạo tác vụ từ endpoint này và lưu task id được trả về.
2

Thăm dò chi tiết tác vụ

Sử dụng Lấy một tác vụ Runway cho đến khi tác vụ đạt trạng thái kết thúc.
3

Lưu trữ kết quả đã biến đổi

Tải xuống hoặc lưu asset đã hoàn tất thông qua pipeline media thông thường của bạn.

Ủ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 API version header, for example 2024-11-06.

Nội dung

application/json
videoUri
string
mặc định:https://your-video-host/source.mp4
bắt buộc

HTTPS URL of the source video, or a base64 data URI containing the video.

promptText
string
mặc định:A cat yawning in slow motion.
bắt buộc

Text prompt describing the desired output. Maximum 1000 characters.

seed
integer
mặc định:1
bắt buộc

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

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

Model variant to use.

references
object[]
bắt buộc

Optional reference images to guide generation. Each item must include type (e.g. image) and uri (HTTPS URL).

ratio
string
mặc định:1280:720
bắt buộc

Requested output frame shape. Use colon-separated values such as 1280:720 or 720:1280; read them as 1280x720 and 720x1280 targets. Do not assume every Runway video-to-video route accepts 1280x720 with an x separator.

contentModeration
object
bắt buộc

Phản hồi

200 - application/json

success

id
string
bắt buộc

The ID of the task that was created. Use this to retrieve the task later.