generate(Reference images)

POST

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

Maintainer:Not configured

Here is a simple example of a GEN-4 graphic raw video transfer.

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

Callback URL, used to receive processing result notifications

image

string

required

Input image URL address

ratio

string

required

Generated video aspect ratio

prompt

string

required

Image processing or generation prompt, describing the expected image content or changes

style

string

optional

Expected image style, for example "cinematic"

model

string

required

Model version used, for example "gen4"

options

object

optional

Specific processing options

seconds

integer

required

Animation or video duration (unit: seconds)

image_as_end_frame

string

required

Whether to use the input image as the last frame of the generated video

flip

string

required

Whether to flip/mirror the image

motion_vector

object

required

Motion vector parameters, used to control dynamic effects

last_image

string

optional

End frame

Example

{
    "callback_url": "http://baidu.com",
    "image": "https://db.xiaohuhd.com/1.jpeg",
    "style": "cinematic",
    "model": "gen4",
    "prompt": "Smile, Eat Burger",
    "options": {
        "seconds": 10,
        "image_as_end_frame": false,
        "flip": false,
        "motion_vector": {
            "x": -6.2,
            "y": 0,
            "z": 0,
            "r": 0,
            "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",
    "image": "https://db.xiaohuhd.com/1.jpeg",
    "style": "cinematic",
    "model": "gen4",
    "prompt": "Smile, Eat Burger",
    "options": {
        "seconds": 10,
        "image_as_end_frame": false,
        "flip": false,
        "motion_vector": {
            "x": -6.2,
            "y": 0,
            "z": 0,
            "r": 0,
            "bg_x_pan": 0,
            "bg_y_pan": 0
        }
    }
}'

Responses

🟢200OK

application/json

success

Body

code

integer

required

HTTP status code or business status code, 200 usually indicates success

msg

string

required

Text description of the status code

data

object

required

Specific response data content

task_id

string

required

Unique identifier of the task, used for subsequent query of task status or results

exec_time

number

required

Time spent processing this request

Example

{
    "code": 200,
    "msg": "success",
    "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
}

generate(text)

Video to Video Style Redraw