API Docs

generate(文生视频

POST

{{BASE_URL}}/runway/v1/pro/generate

最后修改时间：2025-04-22 16:57:24

请求参数

Query 参数

string

可选

Header 参数

Authorization

string

可选

示例值:

sk-xxx

string

可选

Body 参数application/json

ratio

enum<string>

画面尺寸

必需

gen-3仅支持16:9和9:16，图生视频也要传比例,不传默认16:9,枚举值16:9,9:16,1:1,4:3,3:4,21:9

枚举值:

16:99:161:14:33:421:9

prompt

string

描述词

必需

style

string

风格

必需

请看style 列表文档

model

enum<string>

模型

必需

枚举值:

gen2gen3gen4

image

string

可选

选填,不传则是文生视频

options

object

必需

seconds

enum<integer>

视频时长

必需

目前仅支持gen-3、4；传5或10

枚举值:

510

motion_vector

object

镜头控制

必需

目前仅支持gen-2

callback_url

string

必需

示例

{
  "ratio": "16:9",
  "prompt": "一只小猫",
  "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 '{{BASE_URL}}/runway/v1/pro/generate' \
--header 'Authorization: sk-xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ratio": "16:9",
    "prompt": "一只小猫",
    "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

object {0}

示例

{}

修改于 2025-04-22 16:57:24

style 列表

generate(参考图片)