Skip to main content
POST
cURL
Mevcut bir kaynak klibi Runway’in video-to-video iş akışıyla dönüştürmek için bu endpoint’i kullanın. Nihai çıktıyı hemen döndürmek yerine async bir görev başlatır.

Çağırmadan önce

  • Sağlayıcının girdi gereksinimlerine uyan bir kaynak video hazırlayın
  • İstediğiniz özellik seti için gerekli X-Runway-Version header’ını ekleyin
  • Tam bir storyboard yerine, değişikliği açıklayan kısa bir prompt ile başlayın

Çıktı oranı

Bu endpoint, iki nokta üst üste ile ayrılmış ratio değerleri bekler. 1280x720 çıktı için 1280:720, 720x1280 için 720:1280 kullanın; 1280x720 her Runway video-to-video rotasında kabul edilmez.

Görev akışı

1

Kaynak klibi ve prompt'u gönderin

Görevi bu endpoint’ten başlatın ve döndürülen görev kimliğini kaydedin.
2

Görev ayrıntılarını sorgulayın

Görev terminal bir duruma ulaşana kadar Bir Runway görevi alın kullanın.
3

Dönüştürülen sonucu saklayın

Tamamlanan varlığı normal medya işlem hattınız üzerinden indirin veya kalıcı olarak saklayın.

Yetkilendirmeler

Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI key.

Başlıklar

X-Runway-Version
string
gerekli

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

Gövde

application/json
videoUri
string
varsayılan:https://your-video-host/source.mp4
gerekli

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

promptText
string
varsayılan:A cat yawning in slow motion.
gerekli

Text prompt describing the desired output. Maximum 1000 characters.

seed
integer
varsayılan:1
gerekli

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

model
string
varsayılan:gen4_aleph
gerekli

Model variant to use.

references
object[]
gerekli

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

ratio
string
varsayılan:1280:720
gerekli

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
gerekli

Yanıt

200 - application/json

success

id
string
gerekli

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