API reference

image to video

POST

/runway/pro/generate

Last modified:2025-02-05 11:33:56

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Authorization

string

optional

Default:

Body Params application/json

callback_url

string

回调地址

required

Webhook 回调 URL。视频生成状态(生成中进度变化/失败/成功)发生改变之后，生成结果将会以 POST 形式发送到此 Webhook URL。

image

string

参考的图片

required

可供互联网访问并可下载的图片链接

style

string

风格

optional

目前仅支持gen-2

model

enum<string>

模型

required

Allowed values:

gen2gen3

Default:

gen3

prompt

string

描述词

required

支持中文

options

object

参数

optional

motion_vector

object

镜头控制

optional

目前仅支持gen-2

seconds

enum<integer>

视频时长

optional

目前仅支持gen-3

Allowed values:

510

Default:

image_as_end_frame

boolean

是否将图片作为尾帧

optional

目前仅支持gen-3,设置为true后,此图片将作为生成视频的结尾参考,默认为false,即将参考图作为首帧参考进行视频生成

Default:

false

flip

boolean

optional

默认为宽屏,即16:9

Default:

false

last_image

string

尾帧

optional

尾帧

Example

{
  "callback_url": "http://baidu.com",
  "image": "https://db.xiaohuhd.com/1.jpeg",
  "style": "cinematic",
  "model": "gen3",
  "prompt": "smile",
  "options": {
    "seconds": 10,
    "image_as_end_frame": false,
    "flip": false,
    "motion_vector": {
      "x": -6.2,
      "y": 0,
      "z": 0,
      "r": 0,
      "bg_x_pan": 0,
      "bg_y_pan": 0
    }
  }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/runway/pro/generate' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "callback_url": "http://baidu.com",
    "image": "https://db.xiaohuhd.com/1.jpeg",
    "style": "cinematic",
    "model": "gen3",
    "prompt": "smile",
    "options": {
        "seconds":10,
        "image_as_end_frame":false,
        "flip":false,
        "motion_vector": {
            "x": -6.2,
            "y": 0,
            "z": 0,
            "r": 0,
            "bg_x_pan": 0,
            "bg_y_pan": 0
        }
    }
}'

Responses

🟢200成功

application/json

Body

object {0}

Example

{}

text to video

video2video