Skip to main content
POST
cURL
Użyj tego endpointu, aby przekształcić istniejący klip źródłowy za pomocą przepływu pracy Runway video-to-video. Uruchamia on zadanie asynchroniczne zamiast od razu zwracać końcowy wynik.

Zanim go wywołasz

  • Przygotuj wideo źródłowe zgodne z wymaganiami wejściowymi dostawcy
  • Dołącz wymagany nagłówek X-Runway-Version dla zestawu funkcji, którego chcesz użyć
  • Zacznij od jednego krótkiego Promptu opisującego zmianę, a nie pełnego storyboardu

Proporcje wyjściowe

Ten endpoint oczekuje wartości ratio rozdzielonych dwukropkiem. Użyj 1280:720 dla wyjścia 1280x720 oraz 720:1280 dla 720x1280; 1280x720 nie jest akceptowane na każdej trasie Runway video-to-video.

Przepływ zadania

1

Prześlij klip źródłowy i prompt

Uruchom zadanie z tego endpointu i zapisz zwrócone id zadania.
2

Odpytuj szczegóły zadania

Używaj Pobierz zadanie Runway, aż zadanie osiągnie stan końcowy.
3

Zapisz przekształcony wynik

Pobierz lub zapisz gotowy zasób za pomocą standardowego pipeline’u mediów.

Autoryzacje

Authorization
string
header
wymagane

Bearer token authentication. Use your CometAPI key.

Nagłówki

X-Runway-Version
string
wymagane

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

Treść

application/json
videoUri
string
domyślnie:https://your-video-host/source.mp4
wymagane

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

promptText
string
domyślnie:A cat yawning in slow motion.
wymagane

Text prompt describing the desired output. Maximum 1000 characters.

seed
integer
domyślnie:1
wymagane

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

model
string
domyślnie:gen4_aleph
wymagane

Model variant to use.

references
object[]
wymagane

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

ratio
string
domyślnie:1280:720
wymagane

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
wymagane

Odpowiedź

200 - application/json

success

id
string
wymagane

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