API reference

text to video

POST

/runway/pro/generate

Last modified:2025-02-05 11:34:01

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。

ratio

enum<string>

画面尺寸

optional

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

Allowed values:

16:99:161:14:321:9

Default:

16:9

prompt

string

描述词

required

支持中文

style

enum<string>

风格

optional

目前仅支持gen-2

Allowed value:

cinematic

Default:

cinematic

model

enum<string>

模型

required

Allowed values:

gen2gen3

Default:

gen3

options

object

参数

optional

motion_vector

object

镜头控制

optional

目前仅支持gen-2

seconds

enum<integer>

视频时长

optional

目前仅支持gen-3

Allowed values:

510

Default:

Example

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

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

Responses

🟢200成功

application/json

Body

code

integer

required

msg

string

required

data

object

required

task_id

string

任务ID

required

exec_time

number

required

Example

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

get task

image to video