Create Video by Runway

Testing

POST

/runwayml/v1/image_to_video

Create Video by Image from Runway

Request

Body Params application/json

model

string

required

Support gen4_turbo

promptImage

string

required

You can pass in a network image URL or image base64, which will be used as the first frame of the video.

promptText

string

required

Non-empty string

<= 512 characters

seed

string

optional

If not filled in, a random

watermark

boolean

optional

Whether the output video contains the Runway watermark

Default:

false

mode

integer

optional

Enumeration value : 5 /10, default value : 5

ratio

string

optional

Enumeration value :
1280:768
768:1280

Example

{
    "promptImage": "https://img.upanh.tv/2025/05/23/b69ee84d-849d-48c0-863a-40b646190dd6.png",
    "seed": 2372601190,
    "model": "gen4_turbo",
    "promptText": "Cinematic shot of a tranquil indoor pool room. A graceful pink flamingo stands in clear turquoise water, creating subtle ripples. Golden hour light casts dramatic geometric shadows through expansive windows and a glass roof onto minimalist beige walls. Rattan furniture with cream cushions. Lush tropical plants. Serene, high-end resort aesthetic. The flamingo subtly preens.",
    "watermark": false,
    "duration": 10,
    "ratio": "1280:768"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/runwayml/v1/image_to_video' \
--header 'Content-Type: application/json' \
--data-raw '{
    "promptImage": "https://img.upanh.tv/2025/05/23/b69ee84d-849d-48c0-863a-40b646190dd6.png",
    "seed": 2372601190,
    "model": "gen4_turbo",
    "promptText": "Cinematic shot of a tranquil indoor pool room. A graceful pink flamingo stands in clear turquoise water, creating subtle ripples. Golden hour light casts dramatic geometric shadows through expansive windows and a glass roof onto minimalist beige walls. Rattan furniture with cream cushions. Lush tropical plants. Serene, high-end resort aesthetic. The flamingo subtly preens.",
    "watermark": false,
    "duration": 10,
    "ratio": "1280:768"
}'

Responses

🟢200OK

application/json

Body

string

required

message

string

required

code

integer

required

request_id

string

required

data

object

required

task_id

string

required

task_status

string

required

created_at

integer

required

updated_at

integer

required

Example

{
    "id": "2e4f3bc2-c962-4340-a9d0-40edc7c00075",
    "message": "YEScale - RunwayML Image2Video - Submit"
}

Modified at 2025-05-23 07:10:02

Get Video by Task ID(image2video)

Get Video by Task ID