Skip to main content
POST
cURL
Użyj tego endpointu, aby animować jeden obraz źródłowy do wideo Runway.

Zanim go wywołasz

  • Wyślij wymagany nagłówek X-Runway-Version, na przykład 2024-11-06
  • Użyj model: gen3a_turbo
  • Podaj stabilny adres HTTPS promptImage
  • Zacznij od duration: 5 i obsługiwanej wartości ratio dla wybranego modelu/wersji Runway

Duration i ratio

Żądania Runway w oficjalnym formacie używają ratio, a nie size. Odczytuj wartości ratio w stylu rozdzielczości jako ich odpowiednik WxH: 1280:720 odpowiada 1280x720, 720:1280 odpowiada 720x1280, a 1280:768 nadal może zostać wyrenderowane jako 1280x720 w zależności od wybranego modelu/wersji.

Przepływ zadania

1

Wyślij żądanie image-to-video

Utwórz zadanie z obrazem źródłowym i opcjonalnym krótkim Prompt dla ruchu.
2

Zapisz zwrócone id

Zapisz id zadania do późniejszego odpytywania.
3

Sprawdzaj status zadania

Użyj Pobierz zadanie Runway. Jeśli pierwsze odpytywanie zwróci task_not_exist, odczekaj kilka sekund i spróbuj ponownie.

Autoryzacje

Authorization
string
header
wymagane

Bearer token authentication. Use your CometAPI key.

Nagłówki

X-Runway-Version
string
wymagane

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

Treść

application/json
promptImage
string
domyślnie:https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg
wymagane

Source image URL.

model
string
domyślnie:gen3a_turbo
wymagane

Runway image-to-video model ID. Choose an available model from the Models page.

seed
integer

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

promptText
string

Text prompt describing the desired motion or scene. Maximum 512 characters.

watermark
boolean
domyślnie:false

Whether to add a watermark to the output video.

duration
integer
domyślnie:5

Video duration in seconds. Runway support is model/version dependent; use 5 or 10 for the broadest compatibility. CometAPI forwards this value to Runway.

ratio
string
domyślnie:1280:768

Requested output ratio. Accepted values are Runway model/version dependent. With X-Runway-Version 2024-11-06, use a resolution-style value accepted by the selected model, such as 1280:768, 768:1280, 1280:720, or 720:1280. Read these as WxH targets, but completed media may normalize, so inspect the returned file before relying on exact pixels.

Odpowiedź

200 - application/json

Task accepted.

id
string
wymagane