API reference

text to video

POST

/runway/pro/generate

最后修改时间：2025-02-05 11:34:01

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Authorization

string

可选

默认值:

Body 参数application/json

callback_url

string

回调地址

必需

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

ratio

enum<string>

画面尺寸

可选

目前仅支持gen-2,gen-3仅支持16:9和9:16

枚举值:

16:99:161:14:321:9

默认值:

16:9

prompt

string

描述词

必需

支持中文

style

enum<string>

风格

可选

目前仅支持gen-2

枚举值:

cinematic

默认值:

cinematic

model

enum<string>

模型

必需

枚举值:

gen2gen3

默认值:

gen3

options

object

参数

可选

motion_vector

object

镜头控制

可选

目前仅支持gen-2

seconds

enum<integer>

视频时长

可选

目前仅支持gen-3

枚举值:

510

默认值:

示例

{
    "callback_url": "http://baidu.com",
    "ratio": "16:9",
    "prompt": "cat",
    "style": "cinematic",
    "model": "gen3",
    "options": {
        "seconds": 10,
        "motion_vector": {
            "x": 0,
            "y": 0.3999999999999999,
            "z": 0,
            "r": -6,
            "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",
    "ratio": "16:9",
    "prompt": "cat",
    "style": "cinematic",
    "model": "gen3",
    "options": {
        "seconds": 10,
        "motion_vector": {
            "x": 0,
            "y": 0.3999999999999999,
            "z": 0,
            "r": -6,
            "bg_x_pan": 0,
            "bg_y_pan": 0
        }
    }
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

msg

string

必需

data

object

必需

task_id

string

任务ID

必需

exec_time

number

必需

示例

{
    "code": 200,
    "msg": "成功",
    "data": {
        "task_id": "0ab3bfe2-be23-4635-8c35-890fb2c1732d"
    },
    "exec_time": 0.67573
}

get task

image to video