POST
/
api
/
v1
/
aleph
/
generate
生成 Aleph 视频
curl --request POST \
  --url https://api.kie.ai/api/v1/aleph/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "一只雄鹰在夕阳下的山间云雾中翱翔，配以电影级镜头运动",
  "videoUrl": "https://example.com/input-video.mp4",
  "callBackUrl": "https://api.example.com/callback",
  "waterMark": "kie.ai",
  "uploadCn": false
}'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6"
  }
}

​
概述

使用 Runway 先进的 Aleph AI 模型将现有视频转换为增强的动态内容。此端点通过文本引导转换实现精确的视频到视频生成，非常适合从现有视频创建增强的视觉内容。
Runway Aleph API 需要文本提示词和参考视频 URL 来生成转换后的视频。AI 将根据您的文本描述对提供的视频进行修改和增强。

​
身份验证

​
Authorization
string
required
用于 API 身份验证的 Bearer token。从 API 密钥管理页面 获取您的 API 密钥。格式：Bearer YOUR_API_KEY

​
请求体

​
prompt
string
required
指导如何对参考视频进行转换的描述性文本。请具体描述您希望在生成的视频中看到的风格变化、效果和修改。最佳实践：
  • 专注于转换和风格变化，而不是描述视频中已有的内容
  • 包含镜头运动描述（例如：“缓慢放大”、“轨道旋转”）
  • 添加时间元素（例如：“逐渐地”、“平滑地”、“突然地”）
  • 如有需要，指定照明和氛围变化
示例： "转换为梦幻水彩画风格，配以柔和流动的运动效果"
​
videoUrl
string
required
要进行转换的参考视频的 URL。视频应通过 HTTPS 公开访问。要求：
  • 最大文件大小：10MB
  • 必须通过 HTTPS 访问
示例： "https://example.com/input-video.mp4"
​
callBackUrl
string
可选的 webhook URL，用于接收完成通知。当提供时，系统将在视频生成完成时向此 URL 发送 POST 任务结果。回调的好处：
  • 消除轮询任务状态的需要
  • 生成完成时立即通知
  • 在回调负载中包含完整的视频信息
有关详细的回调格式和实施指南，请参阅 Aleph 视频生成回调。示例： "https://api.example.com/webhook/aleph-callback"
​
waterMark
string
可选的水印文本，显示在生成的视频上。留空或省略表示无水印。详情：
  • 文本将出现在视频的底部角落
  • 支持字母数字字符和基本符号
  • 推荐长度：1-20 个字符以获得最佳可见性
示例： "kie.ai"
​
uploadCn
boolean
生成视频的存储位置选择。选项：
  • false（默认）：全球 S3/R2 存储 - 适合国际用户
  • true：阿里云 OSS 存储 - 推荐中国用户使用
示例： false

​
代码示例

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",
    "callBackUrl": "https://api.example.com/callback",
    "waterMark": "kie.ai",
    "uploadCn": false
  }'

​
响应格式

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6"
  }
}
​
code
integer
指示请求结果的状态码
  • 200：成功 - 任务创建成功
  • 400：错误请求 - 参数无效
  • 401：未授权 - API 密钥无效
  • 422：验证错误 - 参数验证失败
  • 451：图像访问错误 - 获取参考图像失败
  • 500：服务器错误 - 发生内部错误
​
msg
string
描述响应状态的可读消息
​
data
object
包含任务信息的响应数据

​
错误响应

{
  "code": 400,
  "msg": "请求参数无效",
  "data": null
}
常见原因：
  • 缺少必需参数（prompt 或 videoUrl）
  • 图像 URL 格式无效
  • 请求体中的 JSON 格式错误

​
下一步

成功创建视频生成任务后，您有几个选择：
1

监控任务状态

使用返回的 taskId 检查生成进度：
curl -X GET "https://api.kie.ai/api/v1/aleph/record-detail?taskId=YOUR_TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

获取任务详情

检查任务状态和检索结果的完整指南
2

处理回调（推荐）

如果您提供了 callBackUrl，请实现 webhook 端点来接收完成通知：

回调实现

学习如何高效处理回调通知
3

下载和处理结果

生成完成后，下载您的视频和缩略图：
// 示例：完成后下载视频
const downloadVideo = async (videoUrl, filename) => {
  const response = await fetch(videoUrl);
  const buffer = await response.arrayBuffer();
  // 保存到文件或根据需要处理
};

​
最佳实践

​
相关端点

获取任务详情

检查生成状态并检索视频 URL

回调指南

实现 webhook 进行异步通知
需要帮助？ 请联系我们的支持团队 support@kie.ai 获取 Runway Alpeh API 的帮助。

Authorizations

​
Authorization
string
header
required

所有 API 都需要通过 Bearer Token 进行身份验证。

获取 API 密钥：

  1. 访问 API 密钥管理页面 获取您的 API 密钥

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

注意：

  • 请确保您的 API 密钥安全，不要与他人分享
  • 如果您怀疑 API 密钥已泄露，请立即在管理页面中重置

Body

application/json

Response

200
application/json

请求成功

The response is of type object.