调用生成 AI 视频时传入 callBackUrl,任务结束后系统会把结果推送到该地址。
回调机制概述#
使用回调无需轮询任务状态,系统会把最终结果主动推送到你的服务器。
Content-Type:application/json
回调请求格式#
回调格式与所有 Market 模型一致。视频地址在 JSON 字符串 data.resultJson 里:JSON.parse(data.resultJson).resultUrls[0]。{
"code": 200,
"msg": "Playground task completed successfully.",
"data": {
"taskId": "94bbfeaa1383c296cd61ba5dfcbfe30e",
"model": "runway",
"state": "success",
"param": "{\"input\":\"{\\\"prompt\\\":\\\"A cartoon fox paints a rainbow on a wooden fence, colorful 3D animation\\\",\\\"duration\\\":5,\\\"quality\\\":\\\"720p\\\",\\\"aspect_ratio\\\":\\\"16:9\\\"}\",\"callBackUrl\":\"https://your-domain.com/api/callback\",\"model\":\"runway\"}",
"resultJson": "{\"resultUrls\":[\"https://tempfile.aiquickdraw.com/p/c03630ba7484476a905fc14625b7304a_1_1791218754_8541.mp4\"]}",
"costTime": 68,
"creditsConsumed": 12,
"createTime": 1791218688000,
"completeTime": 1791218756020,
"updateTime": 1791218756020
}
}
参数说明#
| 参数 | 类型 | 说明 |
|---|
code | integer | 200 成功,501 失败 |
msg | string | 状态消息 |
data.taskId | string | 提交任务时返回的任务 ID |
data.model | string | 任务使用的模型(runway) |
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 毫秒时间戳 |
回调接收示例#
最佳实践#
3.
幂等处理:同一个 taskId 可能收到多次回调。
4.
快速响应 HTTP 200,耗时的业务逻辑异步处理。
故障排查#
替代方案#
获取任务详情
用 taskId 查询任务,结果在 resultJson.resultUrls,与回调一致。