查询任务
查询生成任务的状态和结果。
GET
/api/v1/jobs/recordInfo?taskId=xb_xxx返回当前客户所属任务的最新状态。
查询参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
taskId | string | 是 | 创建接口返回的任务标识 |
响应
{
"code": 200,
"msg": "success",
"data": {
"taskId": "xb_a1b2c3...",
"model": "seedance-2.0",
"state": "success",
"resultJson": "{\"resultUrls\":[\"https://media.xbaiapi.com/video/2026/09/17/xb_a1b2c3.mp4\"]}",
"failMsg": null,
"creditsCharged": 165,
"durationSeconds": 5,
"createTime": 1789651000,
"completeTime": 1789651045,
"expireTime": 1792243000
}
}任务状态
| 状态 | 含义 |
|---|---|
waiting | 任务已提交，正在排队 |
generating | 视频生成中 |
success | 生成成功，从 resultJson.resultUrls 读取结果 |
fail | 生成失败，从 failMsg 读取原因，预扣 credits 已退回 |
结果过期
expireTime 是结果文件的删除时间（Unix 秒），为 createTime 之后 30 天；没有结果的任务为 null。过期后任务状态仍是 success，但 resultJson 变为 null。详见结果文件。
建议每 5 秒左右轮询一次。状态变为 success 或 fail 后停止轮询。