generate(text)

Developing

POST

/runway/v1/pro/generate

TIP

Since the brand-new video generation model GEN-3 was released recently, some parameters from GEN-2 are not yet supported in GEN-3, but it is believed that support will be available soon.
Currently, GEN-3 only supports videos with a 16:9 or 9:16 aspect ratio (regardless of text-to-video or image-to-video).
Here is a simple example of passing parameters for a GEN-3 text-to-video request:

Request

Body Params application/json

Example

{
    "callback_url": "http://baidu.com",
    "ratio": "16:9",
    "prompt": "A kitten",
    "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 Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/runway/v1/pro/generate' \
--header 'Content-Type: application/json' \
--data-raw '{
    "callback_url": "http://baidu.com",
    "ratio": "16:9",
    "prompt": "A kitten",
    "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

🟢200Success

application/json

Body

Example

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

Modified at 2025-07-23 10:01:53

feed

generate (reference image)