Generate AI Video

POST

/api/v1/runway/generate

Create dynamic AI-generated videos from text prompts or image references.

Usage Guide

Create short videos (5-10 seconds) using AI visualization

Generate videos based on text descriptions or reference images

Suitable for social media content, digital art, or concept visualization

Parameter Details

prompt describes what you want to show in the video

imageUrl provides visual reference for AI

aspectRatio determines video orientation (vertical or horizontal)

duration control the video duration (5 or 10 seconds), where if a 10-second video is selected, 1080p resolution cannot be selected

quality video resolution (720p or 1080p), where if 1080p is selected, 10-second video cannot be generated

waterMark video watermark text content, empty string means no watermark

Developer Notes

Generated videos are stored for 14 days before automatic deletion

For text-only generation, aspect ratio must be explicitly specified

Callbacks

onVideoGenerated

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Request successful

Body

🔴500Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.kie.ai/api/v1/runway/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "A fluffy orange cat dancing energetically in a colorful room with disco lights",
    "imageUrl": "https://example.com/cat-image.jpg",
    "model": "runway-duration-5-generate",
    "waterMark": "kie.ai",
    "callBackUrl": "https://api.example.com/callback"
}'

Response Example

200 - 成功示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6"
    }
}

Aleph Video Generation Callbacks

Get AI Video Details