API reference

image to video

POST

/runway/pro/generate

最后修改时间：2025-02-05 11:33:56

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Authorization

string

可选

默认值:

Body 参数application/json

callback_url

string

回调地址

必需

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

image

string

参考的图片

必需

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

style

string

风格

可选

目前仅支持gen-2

model

enum<string>

模型

必需

枚举值:

gen2gen3

默认值:

gen3

prompt

string

描述词

必需

支持中文

options

object

参数

可选

motion_vector

object

镜头控制

可选

目前仅支持gen-2

seconds

enum<integer>

视频时长

可选

目前仅支持gen-3

枚举值:

510

默认值:

image_as_end_frame

boolean

是否将图片作为尾帧

可选

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

默认值:

false

flip

boolean

可选

默认为宽屏,即16:9

默认值:

false

last_image

string

尾帧

可选

尾帧

示例

{
    "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
        }
    }
}

示例代码

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
        }
    }
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

text to video

video2video