​
欢迎使用 Runway Aleph API

Runway Aleph API 让您能够使用 Runway 先进的 Aleph 模型生成高质量的 AI 视频。通过精确的文本引导视频到视频转换将现有视频转换为增强的动态内容，非常适合视频编辑、风格转换和创意视频增强。

视频转视频

使用 AI 驱动的风格转换来转换现有视频

任务管理

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

回调集成

实现 webhook 以进行高效的异步处理

存储选项

在全球和中国专用存储之间选择

​
身份验证

所有 API 请求都需要使用 Bearer token 进行身份验证。从 API 密钥管理页面 获取您的 API 密钥。
请确保您的 API 密钥安全，不要公开分享。如果泄露，请立即重置。

​
API 基础 URL

https://api.kie.ai

​
身份验证头

Authorization: Bearer YOUR_API_KEY

​
快速开始指南

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

从简单的图像转视频生成请求开始： 
curl -X POST "https://api.kie.ai/api/v1/aleph/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "转换为梦幻水彩画风格，配以柔和流动的运动效果",
    "videoUrl": "https://example.com/input-video.mp4",
    "waterMark": "kie.ai",
    "uploadCn": false
  }'

​
第二步：检查任务状态

使用返回的任务 ID 检查生成状态： 
curl -X GET "https://api.kie.ai/api/v1/aleph/record-info?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",
    "paramJson": "{\"prompt\":\"一只雄鹰在夕阳下的山间云雾中翱翔，配以电影级镜头运动\",\"videoUrl\":\"https://example.com/input-video.mp4\"}",
    "response": {
      "taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6",
      "resultVideoUrl": "https://file.com/k/xxxxxxx.mp4",
      "resultImageUrl": "https://file.com/m/xxxxxxxx.png"
    },
    "completeTime": "2023-08-15T14:30:45Z",
    "createTime": "2023-08-15T14:25:00Z",
    "successFlag": 1,
    "errorCode": 0,
    "errorMessage": ""
  }
}

​
核心功能

将静态图像转换为动态视频：
{
  "prompt": "角色开始自信地向前走，镜头平滑跟随",
  "videoUrl": "https://example.com/character-video.mp4",
  "waterMark": "kie.ai"
}

​
关键参数

​
prompt
string
required
指导如何对参考图像进行动画处理的文本描述。请具体描述运动、镜头角度和视觉效果。更好提示词的技巧：
  • 描述具体的运动和动作（例如：“缓慢旋转”、“放大”、“向左平移”）
  • 包含镜头运动描述（例如：“电影级镜头运动”、“平滑跟踪镜头”）
  • 添加氛围和照明细节（例如：“戏剧性照明”、“柔和的晨光”）
  • 指定风格和情绪（例如：“史诗电影风格”、“梦幻空灵”）
​
videoUrl
string
required
要进行转换的参考视频的 URL。AI 将根据您的提示词增强和修改这个视频。视频要求：
  • 最大文件大小：10MB
  • 视频应通过 HTTPS 公开访问
​
callBackUrl
string
可选的回调 URL，用于接收完成通知。当提供时，系统将在生成完成时向此 URL 发送 POST 结果。
​
waterMark
string
可选的水印文本，显示在生成的视频上。留空表示无水印，或提供文本在底部角落显示。
​
uploadCn
boolean
存储位置选择。默认为 false（全球 S3/R2 存储）。设置为 true 使用阿里云 OSS 存储（推荐中国用户使用）。

​
使用回调进行异步处理

对于生产应用程序，使用回调而不是轮询： 
{
  "prompt": "一个宁静的花园，樱花在轻柔的微风中摇摆",
  "videoUrl": "https://example.com/garden-scene.mp4",
  "callBackUrl": "https://your-app.com/webhook/aleph-callback",
  "waterMark": "kie.ai"
}
系统将在生成完成时向您的回调 URL 发送 POST 结果。

了解更多关于回调

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

​
最佳实践

​
状态码

​
200
成功
任务创建成功或请求完成
​
400
错误请求
无效的请求参数或格式错误的 JSON
​
401
未授权
缺少或无效的 API 密钥
​
402
积分不足
账户没有足够的积分进行操作
​
422
验证错误
请求参数验证失败
​
429
速率限制
请求过多 - 实现退避策略
​
451
图像访问错误
获取参考图像失败 - 验证图像 URL 和可访问性
​
500
服务器错误
内部服务器错误 - 如果持续出现请联系支持

​
视频存储和过期

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

​
下一步

生成视频

Alpeh 视频生成的完整 API 参考

任务详情

查询和监控任务状态

回调设置

实现 webhook 进行异步处理

存储指南

选择最佳存储选项

​
支持

需要帮助？我们的技术支持团队随时为您提供帮助。
准备好开始从您的图像生成精美的 AI 视频了吗？获取您的 API 密钥 并立即开始创作！