POST
/
api
/
v1
/
runway
/
generate
生成AI视频
curl --request POST \
  --url https://api.kie.ai/api/v1/runway/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "一只蓬松的橙色猫在有迪斯科灯光的彩色房间里精力充沛地跳舞",
  "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"
  }
}
从文本提示或图像参考创建动态AI生成的视频。

使用指南

  • 使用AI可视化创建短视频(5-8秒)
  • 基于文本描述或参考图像生成视频
  • 适用于社交媒体内容、数字艺术或概念可视化

参数详情

  • prompt 描述您想要在视频中呈现的内容
  • imageUrl 为AI提供视觉参考
  • aspectRatio 确定视频方向(垂直或水平)
  • duration 控制视频时长(5或8秒),其中如果选择了8秒的视频,则无法选择1080p的分辨率
  • quality 视频分辨率(720p或1080p),其中如果选择了1080p,则无法生成8秒的视频
  • waterMark 视频水印文本内容,空字符串表示不添加水印

开发者注意事项

  • 生成的视频存储14天后自动删除
  • 仅文本生成时,必须明确指定宽高比

Authorizations

Authorization
string
header
required

所有接口都需要通过 Bearer Token 方式进行认证。

获取 API Key:

  1. 访问 API Key 管理页面 获取您的 API Key

使用方式: 在请求头中添加: Authorization: Bearer YOUR_API_KEY

注意事项:

  • 请妥善保管您的 API Key,不要泄露给他人
  • 如果怀疑 API Key 泄露,请立即在管理页面重置

Body

application/json

Response

200
application/json

请求成功

The response is of type object.