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://media.w3.org/2010/05/sintel/trailer.mp4",
  "promptText": "Make the motion feel cinematic.",
  "model": "gen4_aleph",
  "references": [
    {
      "type": "image",
      "uri": "https://res.cloudinary.com/demo/image/upload/dog.jpg"
    }
  ],
  "ratio": "1280:720"
}
'
{
  "id": "12a01a5e-ab55-4aa7-b002-7b873546cf76"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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ả 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

Luồng tác vụ

1

Gửi clip nguồn và prompt

Khởi động 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 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://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

id
string
bắt buộc

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