​
欢迎使用 Runway API

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

文本转视频

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

图像转视频

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

视频延长

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

任务管理

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

​
身份验证

所有 API 请求都需要使用 Bearer 令牌进行身份验证。请从 API 密钥管理页面 获取您的 API 密钥。
请妥善保管您的 API 密钥，切勿公开分享。如果怀疑密钥泄露，请立即重置。

​
API 基础 URL

https://api.kie.ai

​
身份验证请求头

Authorization: Bearer YOUR_API_KEY

​
快速开始指南

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

从一个简单的文本转视频生成请求开始： 
curl -X POST "https://api.kie.ai/api/v1/runway/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一只毛茸茸的橙色小猫在彩色房间里充满活力地跳舞，周围有迪斯科灯光",
    "duration": 5,
    "quality": "720p",
    "aspectRatio": "16:9",
    "waterMark": ""
  }'

​
第二步：检查任务状态

使用返回的任务ID检查生成状态： 
curl -X GET "https://api.kie.ai/api/v1/runway/record-detail?taskId=YOUR_TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
响应格式

成功响应： 
{
  "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秒和8秒时长

1080p 全高清

优质质量专业内容的更高分辨率仅适用于5秒视频

​
关键参数

​
prompt
string
required
对所需视频内容的文本描述。请具体说明动作、移动和视觉风格。更好提示词的技巧：
  • 描述具体的动作和移动（如”缓慢行走”、“快速旋转”）
  • 包含视觉风格描述符（如”电影感”、“动画”、“逼真”）
  • 在相关时指定镜头角度（如”特写”、“远景”、“跟踪镜头”）
  • 添加光线和氛围细节（如”黄金时段光线”、“戏剧性阴影”）
​
duration
number
required
视频时长（秒）。可选择：
  • 5 - 5秒视频（兼容720p和1080p）
  • 8 - 8秒视频（仅兼容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
可选的水印文本。留空表示无水印，或提供文本在右下角显示。

​
使用回调的异步处理

对于生产应用，使用回调而不是轮询： 
{
  "prompt": "一个宁静的花园，樱花在微风中摇摆",
  "duration": 5,
  "quality": "720p",
  "aspectRatio": "16:9",
  "callBackUrl": "https://your-app.com/webhook/runway-callback"
}
当生成完成时，系统会将结果POST到您的回调URL。

了解更多关于回调

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

​
视频延长工作流程

通过延长现有视频创建更长的视频序列：
  1. 生成初始视频：使用文本或图像输入创建基础视频
  2. 检查完成状态：等待初始视频成功完成
  3. 延长视频：使用原始任务ID创建延长
  4. 链式延长：重复此过程创建更长的序列
// 第一步：生成初始视频
const initialResponse = await generateVideo({
  prompt: "一只猫开始在彩色房间里跳舞",
  duration: 5,
  quality: "720p",
  aspectRatio: "16:9"
});

// 第二步：等待完成并延长
const extendResponse = await extendVideo({
  taskId: initialResponse.data.taskId,
  prompt: "小猫旋转，活力和兴奋不断增加",
  quality: "720p"
});

​
最佳实践

​
状态码

​
200
成功
任务创建成功或请求完成
​
400
错误请求
无效的请求参数或格式错误的JSON
​
401
未授权
缺少或无效的API密钥
​
402
积分不足
账户没有足够的积分进行操作
​
422
验证错误
请求参数未通过验证检查
​
429
速率限制
请求过多 - 实施退避策略
​
500
服务器错误
内部服务器错误 - 如果持续存在请联系支持

​
视频存储和过期

生成的视频在自动删除前存储 14天。请在此时间范围内下载并保存您的视频。
  • 视频URL在生成后14天内保持可访问
  • 响应中的 expireFlag 表示视频是否已过期（0 = 活跃，1 = 已过期）
  • 规划您的工作流程以在过期前下载或处理视频
  • 考虑为生产使用实施自动下载系统

​
下一步

生成视频

视频生成的完整API参考

延长视频

了解如何延长视频以创建更长序列

回调设置

为异步处理实施webhooks

任务详情

查询和监控任务状态

​
支持

需要帮助吗？我们的技术支持团队随时为您提供帮助。
准备开始生成令人惊叹的AI视频了吗？获取您的API密钥，立即开始创作！