处理 Runway Alpeh 视频生成完成的 webhook 通知
回调提供了一种高效的方式,当您的 Runway Aleph 视频生成任务完成时接收通知。您的应用程序可以通过 webhook 接收即时通知,无需重复轮询 API,当视频准备就绪时立即得到通知。回调是生产应用程序的推荐方法,因为它们减少了 API 调用,提高了响应时间,并提供任务完成的即时通知。
Webhook 安全性:为确保回调请求的真实性和完整性,我们强烈建议您实现 webhook 签名验证。请参阅我们的 Webhook 校验指南 了解详细实现步骤。 回调工作原理#
工作流程#
1.
在您的视频生成请求中包含 callBackUrl 参数:{
"prompt": "转换为梦幻水彩画风格,配以柔和流动的运动效果",
"videoUrl": "https://example.com/input-video.mp4",
"callBackUrl": "https://your-app.com/webhook/aleph-callback"
}
2.
{
"code": 200,
"msg": "success",
"data": {
"taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6"
}
}
3.
生成完成时,我们的系统会向您的回调 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 | 由于内容政策或技术问题生成失败 |
错误回调#
{
"code": 400,
"msg": "您的提示词被我们的 AI 审查员捕获。请调整后重试!",
"data": null,
"taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6"
}
实现回调端点#
安全最佳实践#
测试回调#
本地开发#
对于本地测试,使用 ngrok 等工具暴露您的本地服务器:Webhook 测试工具#
Webhook.site
生成临时 URL 来测试回调负载RequestBin
检查和调试 webhook 请求故障排除#
相关文档#
生成 Aleph 视频
学习如何创建带有回调的视频生成请求