Aleph 视频生成回调
调用生成 Aleph 视频时传入 callBackUrl，任务结束后系统会把结果推送到该地址。
回调机制概述
工作流程
1.
callBackUrl：{
"model": "runway/gen4-aleph",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"prompt": "Turn the scene into a snowy winter day, keep the cartoon fox and the fence",
"video_url": "https://example.com/input-video.mp4"
}
}2.
{
"code": 200,
"msg": "success",
"data": {
"taskId": "5d2e8b7c41f04a6f9e3b0c7a1d6f2e84"
}
}3.
callBackUrl 收到回调。回调请求格式
data.resultJson 里：JSON.parse(data.resultJson).resultUrls[0]。成功回调
失败回调
{
"code": 200,
"msg": "Playground task completed successfully.",
"data": {
"taskId": "5d2e8b7c41f04a6f9e3b0c7a1d6f2e84",
"model": "runway/gen4-aleph",
"state": "success",
"param": "{\"input\":\"{\\\"prompt\\\":\\\"Turn the scene into a snowy winter day, keep the cartoon fox and the fence\\\",\\\"video_url\\\":\\\"https://example.com/input-video.mp4\\\"}\",\"callBackUrl\":\"https://your-domain.com/api/callback\",\"model\":\"runway/gen4-aleph\"}",
"resultJson": "{\"resultUrls\":[\"https://tempfile.aiquickdraw.com/p/xxxxxxxx.mp4\"]}",
"createTime": 1791218957000,
"completeTime": 1791219017000,
"updateTime": 1791219017000
}
}参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
code | integer | 200 成功，501 失败 |
msg | string | 状态消息 |
data.taskId | string | 提交任务时返回的任务 ID |
data.model | string | 任务使用的模型（runway/gen4-aleph） |
data.state | string | success 或 fail |
data.param | string | 创建任务时提交的参数，JSON 字符串 |
data.resultJson | string | 结果，JSON 字符串，如 {"resultUrls":["https://...mp4"]}；成功时返回 |
data.failCode | string | 失败码；失败时返回 |
data.failMsg | string | 失败原因；失败时返回 |
data.costTime | integer | 任务耗时（秒） |
data.creditsConsumed | number | 任务消耗的积分 |
data.createTime / data.completeTime / data.updateTime | integer | Unix 毫秒时间戳 |
回调接收示例
Node.js
Python
PHP
最佳实践
回调地址配置建议
1.
2.
3.
taskId 可能收到多次回调。4.
5.
重要提醒