Aleph 视频生成回调

处理 Runway Alpeh 视频生成完成的 webhook 通知

概述

回调提供了一种高效的方式，当您的 Runway Aleph 视频生成任务完成时接收通知。您的应用程序可以通过 webhook 接收即时通知，无需重复轮询 API，当视频准备就绪时立即得到通知。

回调是生产应用程序的推荐方法，因为它们减少了 API 调用，提高了响应时间，并提供任务完成的即时通知。

Webhook 安全性：为确保回调请求的真实性和完整性，我们强烈建议您实现 webhook 签名验证。请参阅我们的 Webhook 校验指南了解详细实现步骤。

回调工作原理

工作流程

提交生成请求

在您的视频生成请求中包含 callBackUrl 参数：

{
  "prompt": "转换为梦幻水彩画风格，配以柔和流动的运动效果",
  "videoUrl": "https://example.com/input-video.mp4",
  "callBackUrl": "https://your-app.com/webhook/aleph-callback"
}

接收任务 ID

API 立即返回任务 ID，同时开始处理：

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

处理回调

生成完成时，我们的系统会向您的回调 URL 发送包含结果的 POST 请求。

回调负载

视频生成完成时，您将收到包含以下负载的 POST 请求：

成功回调

{
  "code": 200,
  "msg": "success",
  "data": {
    "result_video_url": "https://file.com/k/xxxxxxx.mp4",
    "result_image_url": "https://file.com/m/xxxxxxxx.png"
  },
  "taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6"
}

参数说明

参数	类型	必需	说明
`code`	integer	是	指示结果的状态码
`msg`	string	是	描述结果的可读消息
`data.result_video_url`	string	是	访问和下载生成视频的 URL（有效期 14 天）
`data.result_image_url`	string	是	生成视频的缩略图 URL
`taskId`	string	是	来自您生成请求的原始任务 ID

状态码详情

状态码	说明
200	视频生成成功
400	由于内容政策或技术问题生成失败
500	内部错误，请重试

错误回调

{
  "code": 400,
  "msg": "您的提示词被我们的 AI 审查员捕获。请调整后重试！",
  "data": null,
  "taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6"
}

内部错误回调

{
  "code": 500,
  "data": {
    "result_image_url": ""
  },
  "msg": "内部错误，请重试。",
  "taskId": "..."
}

实现回调端点

以下是用流行编程语言实现回调端点的示例：

Node.js/Express

Python/Flask

PHP

安全最佳实践

验证回调来源

处理重复回调

错误处理和重试逻辑

测试回调

本地开发

对于本地测试，使用 ngrok 等工具暴露您的本地服务器：

Webhook 测试工具

Webhook.site

生成临时 URL 来测试回调负载

RequestBin

检查和调试 webhook 请求

故障排除

未收到回调

重复或丢失的回调

回调负载问题

Aleph 视频生成回调

概述#

回调工作原理#

工作流程#

回调负载#

成功回调#

参数说明#

状态码详情#

错误回调#

内部错误回调#

实现回调端点#

安全最佳实践#

测试回调#

本地开发#

Webhook 测试工具#

故障排除#

相关文档#

概述

回调工作原理

工作流程

回调负载

成功回调

参数说明

状态码详情

错误回调

内部错误回调

实现回调端点

安全最佳实践

测试回调

本地开发

Webhook 测试工具

故障排除

相关文档