生成AI视频

POST 
https://kieai.erweima.ai/api/v1/runway/generate

从文本提示或图像参考创建动态AI生成的视频。

使用指南

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

参数详情

• prompt 描述您想要在视频中呈现的内容
• imageUrl 为AI提供视觉参考
• aspectRatio 确定视频方向（垂直或水平）
• model 控制视频时长（5或10秒）
• waterMark 视频水印文本内容，传入空字符串表示不添加水印

开发者注意事项

• 生成的视频存储14天后自动删除
• 基于图像的生成需要兼容的宽高比（16:9或9:16）
• 仅文本生成时，必须明确指定宽高比

Request

application/json

Bodyrequired

promptstring
指导AI视频生成的描述性文本。具体说明主题、动作、风格和场景。当与图像一起使用时，描述如何为图像内容添加动画或修改。
Example: 一只蓬松的橙色猫在有迪斯科灯光的彩色房间里精力充沛地跳舞
imageUrlstring
可选的参考图像URL，作为视频的基础。图像必须匹配预期的宽高比（16:9或9:16）。提供后，AI将创建一个为此图像添加动画或扩展的视频。
Example: https://example.com/cat-image.jpg
aspectRatiostringrequired
视频宽高比参数。所有视频生成请求的必填参数。
• 基础宽高比（所有模型均支持）：

  • "16:9" - 水平/横向格式（例如，标准宽屏）
  • "9:16" - 垂直/纵向格式（例如，手机视频）

• 其他宽高比（仅runway-gen4-turbo系列模型支持）：

  • "1:1" - 正方形格式
  • "4:3" - 传统电视/显示器格式
  • "3:4" - 垂直传统格式
  • "21:9" - 超宽电影格式
当使用imageUrl参数时，aspectRatio必须与您提供的参考图像尺寸匹配。
Possible values: [16:9, 9:16, 1:1, 4:3, 3:4, 21:9]
Example: 9:16
modelstring
视频时长模型选择：
• runway-duration-5-generate：5秒视频，支持16:9和9:16宽高比，可以使用/api/v1/runway/extend接口
• runway-duration-10-generate：10秒视频，支持16:9和9:16宽高比，可以使用/api/v1/runway/extend接口
• runway-gen4-turbo-duration-5-generate：Runway Gen-4 Turbo 5秒视频，支持所有宽高比（16:9、9:16、1:1、4:3、3:4、21:9），不支持/api/v1/runway/extend接口
• runway-gen4-turbo-duration-10-generate：Runway Gen-4 Turbo 10秒视频，支持所有宽高比（16:9、9:16、1:1、4:3、3:4、21:9），不支持/api/v1/runway/extend接口
Possible values: [runway-duration-5-generate, runway-duration-10-generate, runway-gen4-turbo-duration-5-generate, runway-gen4-turbo-duration-10-generate]
Default value: runway-duration-5-generate
Example: runway-duration-5-generate
waterMarkstring
视频水印文本内容。当传入空字符串时表示不添加水印，传入非空字符串时将在视频中显示指定的水印文本。水印将显示在视频的右下角位置。
Example: kie.ai
callBackUrlstringrequired
接收视频生成完成通知的URL。您的服务器应配置为在此URL接受POST请求。
Example: https://api.example.com/callback

Responses

200

请求成功

application/json

Schema

Schema

codeStatusCode (integer)
响应状态码
Enum Value	Description
200	成功 - 请求已成功处理
401	未授权 - 缺少身份验证凭据或凭据无效
402	积分不足 - 账户没有足够的积分执行此操作
404	未找到 - 请求的资源或端点不存在
422	参数错误 - 请求参数未通过验证检查
429	超出限制 - 已超过对此资源的请求限制
455	服务不可用 - 系统当前正在进行维护
500	服务器错误 - 在处理请求时发生意外错误
505	功能已禁用 - 请求的功能当前已禁用
Possible values: [200, 401, 402, 404, 422, 429, 455, 500, 505]
msgstring
当 code != 200 时的错误信息
Example: success
data object
taskIdstring
生成任务的唯一标识符，可使用 获取AI视频详情 查询
Example: ee603959-debb-48d1-98c4-a6d1c717eba6

Example (auto)

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

Example

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

500

服务器错误

Callbacks

POST onVideoGenerated

POST 
{$request.body#/callBackUrl}

当视频生成完成后，系统会向提供的回调 URL 发送 POST 请求通知结果

application/json

Bodyrequired

codeintegerrequired
状态码，200 表示成功
Example: 200
msgstringrequired
状态信息
Example: All generated successfully.
data objectrequired
image_urlstringrequired
生成视频的封面图片 URL
Example: https://file.com/m/xxxxxxxx.png
taskIdstringrequired
生成任务的唯一标识符，可用于查询任务状态
Example: ee603959-debb-48d1-98c4-a6d1c717eba6
video_idstringrequired
视频 ID
Example: 485da89c-7fca-4340-8c04-101025b2ae71
video_urlstringrequired
可访问的视频 URL，有效期 14 天
Example: https://file.com/k/xxxxxxx.mp4

Callbacks Responses

200

回调接收成功

Authorization: http

name: BearerAuthtype: httpscheme: bearerbearerFormat: API Keydescription: 所有接口都需要通过 Bearer Token 方式进行认证。

获取 API Key:
1. 访问 [API Key 管理页面](https://kie.ai/api-key) 获取您的 API Key

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

注意事项：
- 请妥善保管您的 API Key，不要泄露给他人
- 如果怀疑 API Key 泄露，请立即在管理页面重置

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://kieai.erweima.ai/api/v1/runway/generate");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var content = new StringContent("{\n  \"prompt\": \"一只蓬松的橙色猫在有迪斯科灯光的彩色房间里精力充沛地跳舞\",\n  \"imageUrl\": \"https://example.com/cat-image.jpg\",\n  \"aspectRatio\": \"9:16\",\n  \"model\": \"runway-duration-5-generate\",\n  \"waterMark\": \"kie.ai\",\n  \"callBackUrl\": \"https://api.example.com/callback\"\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Request Collapse all

Base URL

https://kieai.erweima.ai

Auth

Bearer Token

Body required

• Example (from schema)
• Example

{
  "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"
}

ResponseClear

Click the Send API Request button above and see the response here!