Chuyển đến nội dung chính
POST
/
runwayml
/
v1
/
video_to_video
Generate a video from a video
curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/video_to_video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "videoUri": "https://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4",
  "promptText": "string",
  "seed": 4294967295,
  "model": "gen4_aleph",
  "references": [
    {
      "type": "image",
      "uri": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg"
    }
  ],
  "ratio": "1280:720",
  "contentModeration": {
    "publicFigureThreshold": "auto"
  }
}
'
{}
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 chạy một tác vụ bất đồng bộ thay vì trả về ngay kết quả đầu ra cuối cùng.

Trước khi gọi

  • Chuẩn bị một video nguồn đáp ứng các yêu cầu đầu vào của nhà cung cấp
  • Thê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

Luồng tác vụ

1

Gửi clip nguồn và prompt

Khởi chạy 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 Runway để Lấy Chi Tiết Tác Vụ cho đến khi tác vụ đạt đến 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 quy trình media thông thường của bạn.

Lưu ý về wrapper của CometAPI

CometAPI giữ nguyên mô hình tác vụ bất đồng bộ và hành vi request theo phiên bản của Runway, nhưng thống nhất việc xác thực và xử lý base URL với phần còn lại của nền tảng.

Ủ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://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.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

Aspect ratio of the output video, e.g. 1280:720.

contentModeration
object
bắt buộc

Phản hồi

200 - application/json

success

The response is of type object.