Runway API 快速开始
几分钟内开始使用 Runway API 生成令人惊叹的AI视频
欢迎使用 Runway API
身份验 证
API 基础 URL
https://api.kie.ai身份验证请求头
快速开始指南
第一步：生成您的第一个视频
Node.js
Python
cURL
第二步：检查任务状态
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"
}视频质量选项
关键参数
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)
waterMark (string)
完整工作流程示例
JavaScript
Python
使用回调的异步处理
{
"prompt": "一个宁静的花园，樱花在微风中摇摆",
"duration": 5,
"quality": "720p",
"aspectRatio": "16:9",
"callBackUrl": "https://your-app.com/webhook/runway-callback"
}视频延长工作流程
1.
2.
3.
4.
最佳实践
视频提示词工程
性能优化
质量和时长选择
错误处理
状态码
200 (成功)
400 (错误请求)
401 (未授权)
402 (积分不足)
422 (验证错误)
429 (速率限制)
500 (服务器错误)
任务状态说明
state: wait (等待中)
state: queueing (排队中)
state: generating (生成中)
state: success (成功)
state: fail (失败)
视频存储和过期
expireFlag 表示视频是否已过期（0 = 活跃，1 = 已过期）