🎉 New Models Available: grok-4 now live!
→ Explore New Features

generate(text)

POST

https://api.cometapi.com/runway/pro/generate

Maintainer:Not configured

Here is a simple example of a GEN-4 Vincennes video pass.

Request

Header Params

Authorization

string

optional

Example:

Bearer {{api-key}}

X-Runway-Version

string

optional

Example:

2024-11-06

Body Params application/json

callback_url

string

required

After the task is completed, results will be sent via POST request to this callback URL

ratio

string

required

Aspect ratio of the generated video

prompt

string

required

Text description or prompt used to generate video content

style

string

required

Artistic style of the generated video

model

string

required

Video generation model version or name used

options

object

required

Other advanced configuration options

seconds

integer

required

Expected duration of the generated video (in seconds)

motion_vector

object

required

Camera movement or motion control parameters

Example

{
    "callback_url": "http://baidu.com",
    "ratio": "16:9",
    "prompt": "a cat",
    "style": "cinematic",
    "model": "gen4",
    "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 --request POST 'https://api.cometapi.com/runway/pro/generate' \
--header 'Authorization: Bearer {{api-key}}' \
--header 'X-Runway-Version: 2024-11-06' \
--header 'Content-Type: application/json' \
--data-raw '{
    "callback_url": "http://baidu.com",
    "ratio": "16:9",
    "prompt": "a cat",
    "style": "cinematic",
    "model": "gen4",
    "options": {
        "seconds": 10,
        "motion_vector": {
            "x": 0,
            "y": 0.3999999999999999,
            "z": 0,
            "r": -6,
            "bg_x_pan": 0,
            "bg_y_pan": 0
        }
    }
}'

Responses

🟢200OK

application/json

success

Body

code

integer

required

HTTP status code or business status code

msg

string

required

Text description of the status code

data

object

required

Business data body containing detailed task information

task_id

string

required

Unique identifier of the created task

exec_time

number

required

Execution time of the API interface itself (in seconds), does not represent the total video generation time

Example

{
    "code": 200,
    "msg": "succeed",
    "data": {
        "task_id": "9f6243e5-3ab8-49c3-9c3c-6309ef5c96bd",
        "state": "",
        "status": "",
        "prompt": "",
        "prompt_en": null,
        "video_url": null,
        "poster": null,
        "last_frame": null,
        "msg": null,
        "point": "",
        "refund": "",
        "create_time": "",
        "update_time": ""
    },
    "exec_time": 20.930577
}

runway to get task details

generate(Reference images)