Image to Video

Użyj CometAPI, aby wywołać Runway image_to_video i przekształcić adres URL statycznego obrazu w surowe wyjście wideo, z obsługą X-Runway-Version dla zgodności.

POST /runwayml/v1/image_to_video

Create a Runway image-to-video task

cURL

curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/image_to_video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
  "model": "gen3a_turbo"
}
'

200

{
  "id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}

Użyj tego endpointu, aby animować jeden obraz źródłowy do postaci 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 w promptImage
• Zacznij od duration: 5 i popularnych proporcji, takich jak 1280:720

​

Przepływ zadania

1. Prześlij żądanie image-to-video

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

2. Zapisz zwrócone id

   Zapisz id zadania do późniejszego odpytywania.

3. Sprawdzaj status zadania

   Użyj Get Task Details. Jeśli pierwsze odpytywanie zwróci task_not_exist, odczekaj kilka sekund i spróbuj ponownie.

Walidacja na żywo z dnia 2026-03-13 potwierdziła, że minimalne żądanie gen3a_turbo zostało zaakceptowane i zwróciło id. Po krótkim opóźnieniu zarówno oficjalne szczegóły zadania, jak i odwrotny feed zwróciły ten sam opakowany status queued dla tego zadania.

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 a current 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. Accepted values: 5 or 10.

ratio · enum<string> · domyślnie: 1280:720

Aspect ratio of the output video.

Dostępne opcje: 1280:720, 720:1280, 1104:832, 832:1104, 960:960, 1584:672, 1280:768, 768:1280

Odpowiedź

200 - application/json

Task accepted.

id · string · wymagane