Runway API 快速开始

几分钟内开始使用 Runway API 生成令人惊叹的AI视频

欢迎使用 Runway API

Runway API 让您能够使用 Runway 先进AI模型的强大功能生成高质量的AI视频。无论您是在构建应用、自动化工作流程还是创建动态内容，我们的API都为AI视频生成提供了简单可靠的访问方式。

文本转视频

将文本提示转换为动态视频内容

图像转视频

将现有图像制作成引人入胜的视频

视频延长

延长视频以创建更长的序列

任务管理

跟踪和监控您的视频生成任务

身份验证

所有 API 请求都需要使用 Bearer 令牌进行身份验证。请从 API 密钥管理页面获取您的 API 密钥。

请妥善保管您的 API 密钥，切勿公开分享。如果怀疑密钥泄露，请立即重置。

API 基础 URL

https://api.kie.ai

身份验证请求头

快速开始指南

第一步：生成您的第一个视频

从一个简单的文本转视频生成请求开始：

Node.js

Python

cURL

第二步：检查任务状态

使用返回的任务ID检查生成状态：

Node.js

Python

cURL

响应格式

成功响应：

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

任务状态响应：

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6",
    "state": "success",
    "generateTime": "2023-08-15 14:30:45",
    "videoInfo": {
      "videoId": "485da89c-7fca-4340-8c04-101025b2ae71",
      "videoUrl": "https://file.com/k/xxxxxxx.mp4",
      "imageUrl": "https://file.com/m/xxxxxxxx.png"
    },
    "expireFlag": 0
  }
}

生成类型

文本转视频

图像转视频

视频延长

从文本描述生成视频：

{
  "prompt": "一只雄伟的老鹰在日落时分翱翔穿过山间云层",
  "duration": 5,
  "quality": "720p",
  "aspectRatio": "16:9"
}

视频质量选项

为您的需求选择合适的质量：

720p 高清

标准质量

平衡文件大小和质量，适合大多数应用

兼容5秒和10秒时长

1080p 全高清

优质质量

专业内容的更高分辨率

仅适用于5秒视频

关键参数

`prompt` (string, required)

对所需视频内容的文本描述。请具体说明动作、移动和视觉风格。

更好提示词的技巧：

描述具体的动作和移动（如"缓慢行走"、"快速旋转"）

包含视觉风格描述符（如"电影感"、"动画"、"逼真"）

在相关时指定镜头角度（如"特写"、"远景"、"跟踪镜头"）

添加光线和氛围细节（如"黄金时段光线"、"戏剧性阴影"）

`duration` (number, required)

视频时长（秒）。可选择：

5 - 5秒视频（兼容720p和1080p）

10 - 10秒视频（仅兼容720p）

`quality` (string, required)

视频分辨率质量：

720p - 高清质量，兼容所有时长

1080p - 全高清质量，仅适用于5秒视频

`aspectRatio` (string, required)

视频宽高比。可选择：

16:9 - 宽屏（推荐用于横向内容）

9:16 - 垂直（完美适用于移动端和社交媒体）

1:1 - 方形（社交媒体帖子）

4:3 - 传统格式

3:4 - 肖像方向

`imageUrl` (string)

可选的参考图像URL来制作动画。提供后，AI将基于此图像创建视频。

`waterMark` (string)

可选的水印文本。留空表示无水印，或提供文本在右下角显示。

完整工作流程示例

以下是一个生成视频并等待完成的完整示例：

JavaScript

Python

使用回调的异步处理

对于生产应用，使用回调而不是轮询：

{
  "prompt": "一个宁静的花园，樱花在微风中摇摆",
  "duration": 5,
  "quality": "720p",
  "aspectRatio": "16:9",
  "callBackUrl": "https://your-app.com/webhook/runway-callback"
}

当生成完成时，系统会将结果POST到您的回调URL。

了解更多关于回调

实现和处理 Runway API 回调的完整指南

视频延长工作流程

通过延长现有视频创建更长的视频序列：

生成初始视频：使用文本或图像输入创建基础视频

检查完成状态：等待初始视频成功完成

延长视频：使用原始任务ID创建延长

链式延长：重复此过程创建更长的序列

最佳实践

视频提示词工程

专注于动作和移动而不是静态描述

包含时间元素（如"逐渐"、"突然"、"缓慢"）

在相关时描述镜头移动（如"拉近"、"左摇"）

在延长过程中保持主题和风格的一致性

性能优化

使用回调而不是频繁轮询

实施适当的错误处理和重试逻辑

考虑视频时长与质量的权衡

缓存结果并实施高效的存储解决方案

质量和时长选择

为更长的视频（10秒）或文件大小重要时选择720p

为高质量短视频（仅5秒）使用1080p

考虑目标平台的要求（社交媒体、网页等）

测试不同组合以找到用例的最佳设置

错误处理

始终检查响应状态码

为重试实施指数退避

优雅地处理速率限制

监控任务状态并适当处理失败

状态码

`200` (成功)

任务创建成功或请求完成

`400` (错误请求)

无效的请求参数或格式错误的JSON

`401` (未授权)

缺少或无效的API密钥

`402` (积分不足)

账户没有足够的积分进行操作

`422` (验证错误)

请求参数未通过验证检查

`429` (速率限制)

请求过多 - 实施退避策略

`500` (服务器错误)

内部服务器错误 - 如果持续存在请联系支持

任务状态说明

`state: wait` (等待中)

任务已创建，等待处理

`state: queueing` (排队中)

任务正在排队等待处理

`state: generating` (生成中)

任务正在生成处理中

`state: success` (成功)

任务成功完成

`state: fail` (失败)

任务生成失败

视频存储和过期

生成的视频在自动删除前存储 14天。请在此时间范围内下载并保存您的视频。

视频URL在生成后14天内保持可访问

响应中的 expireFlag 表示视频是否已过期（0 = 活跃，1 = 已过期）

规划您的工作流程以在过期前下载或处理视频

考虑为生产使用实施自动下载系统

支持

需要帮助吗？我们的技术支持团队随时为您提供帮助。

邮箱: support@kie.ai

文档: docs.kie.ai

API状态: 查看我们的状态页面了解实时API健康状况

Runway API 快速开始

欢迎使用 Runway API#

身份验证#

API 基础 URL#

身份验证请求头#

快速开始指南#

第一步：生成您的第一个视频#

第二步：检查任务状态#

响应格式#

生成类型#

视频质量选项#

关键参数#

prompt (string, required)#

duration (number, required)#

quality (string, required)#

aspectRatio (string, required)#

imageUrl (string)#

waterMark (string)#

完整工作流程示例#

使用回调的异步处理#

视频延长工作流程#

最佳实践#

状态码#

200 (成功)#

400 (错误请求)#

401 (未授权)#

402 (积分不足)#

422 (验证错误)#

429 (速率限制)#

500 (服务器错误)#

任务状态说明#

state: wait (等待中)#

state: queueing (排队中)#

state: generating (生成中)#

state: success (成功)#

state: fail (失败)#

视频存储和过期#

支持#

欢迎使用 Runway API

身份验证

API 基础 URL

身份验证请求头

快速开始指南

第一步：生成您的第一个视频

第二步：检查任务状态

响应格式

生成类型

视频质量选项

关键参数

`prompt` (string, required)

`duration` (number, required)

`quality` (string, required)

`aspectRatio` (string, required)

`imageUrl` (string)

`waterMark` (string)

完整工作流程示例

使用回调的异步处理

视频延长工作流程

最佳实践

状态码

`200` (成功)

`400` (错误请求)

`401` (未授权)

`402` (积分不足)

`422` (验证错误)

`429` (速率限制)

`500` (服务器错误)

任务状态说明

`state: wait` (等待中)

`state: queueing` (排队中)

`state: generating` (生成中)

`state: success` (成功)

`state: fail` (失败)

视频存储和过期

支持