POST
/
api
/
v1
/
runway
/
generate
Generate AI Video
curl --request POST \
  --url https://api.kie.ai/api/v1/runway/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A fluffy orange cat dancing energetically in a colorful room with disco lights",
  "imageUrl": "https://example.com/cat-image.jpg",
  "aspectRatio": "9:16",
  "model": "runway-duration-5-generate",
  "waterMark": "kie.ai",
  "callBackUrl": "https://api.example.com/callback"
}'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6"
  }
}

​
Usage Guide

  • Create short videos (5-8 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 8 seconds), where if an 8-second video is selected, 1080p resolution cannot be selected
  • quality video resolution (720p or 1080p), where if 1080p is selected, 8-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

Authorizations

​
Authorization
string
header
required

All APIs require authentication via Bearer Token.

Get API Key:

  1. Visit API Key Management Page to get your API Key

Usage: Add to request header: Authorization: Bearer YOUR_API_KEY

Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately in the management page

Body

application/json

Response

200
application/json

Request successful

The response is of type object.