Ana içeriğe atla
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"
  }
}
'
{}
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 eşzamansız 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

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 duruma ulaşana kadar Runway ile Görev Ayrıntılarını Alın seçeneğini 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.

CometAPI sarmalayıcı notu

CometAPI, Runway’in eşzamansız görev modelini ve sürümlü istek davranışını korur, ancak kimlik doğrulama ve temel URL yönetimini platformun geri kalanıyla birleştirir.

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

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

contentModeration
object
gerekli

Yanıt

200 - application/json

success

The response is of type object.