Tạo Video từ một Video

Sử dụng CometAPI Runway POST /runwayml/v1/video_to_video để khởi chạy tác vụ tạo video-to-video, thiết lập X-Runway-Version và biến đổi clip nguồn.

POST /runwayml/v1/video_to_video

Generate a video from a video

cURL

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"
  }
}
'

200

{}

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

Show child attributes

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

Show child attributes

Phản hồi

200 - application/json

success

The response is of type object.