Skip to main content
POST
cURL
Gunakan endpoint ini untuk mentransformasikan klip sumber yang sudah ada dengan workflow video-to-video Runway. Endpoint ini memulai task async alih-alih langsung mengembalikan output final.

Sebelum Anda memanggilnya

  • Siapkan video sumber yang sesuai dengan persyaratan input penyedia
  • Sertakan header X-Runway-Version yang diperlukan untuk set fitur yang Anda inginkan
  • Mulailah dengan satu prompt singkat yang menjelaskan perubahan, bukan storyboard lengkap

Rasio output

Endpoint ini mengharapkan nilai ratio yang dipisahkan dengan titik dua. Gunakan 1280:720 untuk output 1280x720 dan 720:1280 untuk 720x1280; 1280x720 tidak diterima di setiap rute video-to-video Runway.

Alur task

1

Kirim klip sumber dan prompt

Mulai task dari endpoint ini dan simpan task id yang dikembalikan.
2

Polling detail task

Gunakan Dapatkan task Runway hingga task mencapai status terminal.
3

Simpan hasil transformasi

Unduh atau simpan aset yang sudah selesai melalui pipeline media normal Anda.

Otorisasi

Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Header

X-Runway-Version
string
wajib

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

Body

application/json
videoUri
string
default:https://your-video-host/source.mp4
wajib

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

promptText
string
default:A cat yawning in slow motion.
wajib

Text prompt describing the desired output. Maximum 1000 characters.

seed
integer
default:1
wajib

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

model
string
default:gen4_aleph
wajib

Model variant to use.

references
object[]
wajib

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

ratio
string
default:1280:720
wajib

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
wajib

Respons

200 - application/json

success

id
string
wajib

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