任务完成回调
在任务进入终态时接收 Webhook 通知。
创建任务时填写 callBackUrl 后，任务进入 success 或 fail 状态时，xbapi 会发送一次 POST 请求。
回调内容
{
"code": 200,
"msg": "success",
"data": {
"taskId": "xb_a1b2c3...",
"model": "seedance-2.0",
"state": "success",
"resultUrl": "https://media.xbaiapi.com/video/2026/09/17/xb_a1b2c3.mp4",
"failMsg": null,
"creditsCharged": 165,
"completeTime": 1789651045,
"expireTime": 1792243000
}
}投递规则
| 规则 | 行为 |
|---|---|
| 时机 | 只在任务进入终态时发送，不推送中间进度 |
| 成功 | 任意 HTTP 2xx 响应都表示接收成功 |
| 重试 | 网络错误和非 2xx 响应会触发重试，总共尝试 4 次 |
| 重复 | 极端情况下可能重复投递，请按 taskId 去重 |
expireTime 是结果文件的删除时间，为任务创建后 30 天；失败任务为 null。请在此之前下载文件。
请尽快返回 2xx，耗时处理应转入你自己的任务队列。