查询任务结果

通过任务 ID 查询处理状态、生成结果、Token 用量和最终扣费。

最后更新: 2026-08-06

GET/api/v1/video/task/detail/{taskId}

按任务编号查询当前 API Key 所属用户的异步生成任务。

任务状态

视频生成任务的 status 字段共有且仅有以下 7 种状态。QUEUED、PROCESSING 为自动执行中的非终态；SUCCEEDED、FAILED、EXPIRED 为终态；SUBMIT_UNKNOWN、BILLING_PENDING 为需要管理员对账处理的异常状态。

状态	是否终态	说明
QUEUED	否	任务已创建并冻结额度，等待消息投递和处理通道受理。
PROCESSING	否	处理通道已受理，正在生成或等待下一次轮询。
SUCCEEDED	是	任务成功并已完成结算，可读取 output、usage 和 billing。
FAILED	是	任务失败并已释放冻结金额，可读取 error。
EXPIRED	是	任务超过 executionExpiresAfter 后终止，可读取 error。
SUBMIT_UNKNOWN	否（需对账）	提交请求可能已到达处理通道但结果不确定；管理员核对后转为 PROCESSING 或 FAILED。
BILLING_PENDING	否（需对账）	处理通道任务已成功，但资金结算尚未完成；管理员完成对账后转为 SUCCEEDED。

QUEUED → PROCESSING → SUCCEEDED
   │          ├────→ FAILED
   │          ├────→ EXPIRED
   │          └────→ BILLING_PENDING → SUCCEEDED
   └───────────────→ SUBMIT_UNKNOWN → PROCESSING / FAILED

响应字段

字段	类型	出现状态	说明
taskId	string	全部	EaseRouter 统一任务编号。
status	string	全部	数据库保存并原样返回的大写任务状态。
model	string	全部	平台模型编码。
output	object	SUCCEEDED	成功结果对象，其他状态不返回。
output.type	string	SUCCEEDED	当前固定为 VIDEO。
output.resultUrl	string	SUCCEEDED	处理通道返回的结果地址。
output.lastFrameUrl	string	SUCCEEDED 且请求返回尾帧	生成视频的最后一帧图片地址；未请求或处理通道未返回时省略。
output.expiresAt	datetime	SUCCEEDED 且有值	resultUrl 的失效时间；空值会被省略。
usage	object	SUCCEEDED	本次任务最终 Token 用量。
usage.inputTokens	integer	SUCCEEDED	输入 Token。
usage.outputTokens	integer	SUCCEEDED	输出 Token。
usage.totalTokens	integer	SUCCEEDED	总 Token。
billing	object	SUCCEEDED	任务最终计费结果。
billing.currency	string	SUCCEEDED	当前固定为 CNY。
billing.chargeAmount	string	SUCCEEDED	最终扣费金额，固定八位小数。
billing.pricePerMillionTokens	string	SUCCEEDED	创建任务时生效的每百万 Token 销售价，固定八位小数。
error	object	异常或失败状态	FAILED、EXPIRED、SUBMIT_UNKNOWN 或 BILLING_PENDING 时返回。
error.code	string	异常或失败状态	与具体处理通道无关的稳定公开错误码；空值会被省略。
error.message	string	异常或失败状态	任务保存的失败说明；空值会被省略。
createdAt	datetime	全部	任务创建时间。
completedAt	datetime	终态	任务成功、失败或过期的结束时间。
requestId	string	全部	请求追踪 ID。

任务错误码

查询接口本身成功时，顶层 code 仍为 SUCCESS；异步任务错误位于 result.error.code。业务程序应根据 error.code 判断错误类型，error.message 仅用于向用户展示。

错误码	对应状态	说明
TASK_PROCESSING_FAILED	FAILED	任务处理失败，或失败原因无法归入其他稳定错误类型。
PROCESSING_CHANNEL_UNAVAILABLE	FAILED	处理通道暂时不可用、连接失败、超时或限流。
TASK_STATUS_CONFIRMING	SUBMIT_UNKNOWN	任务提交结果正在确认，请稍后重新查询。
TASK_SETTLEMENT_PENDING	BILLING_PENDING	任务结算正在确认，请稍后重新查询。
EXECUTION_TIMEOUT	EXPIRED	任务超过 executionExpiresAfter 指定的执行期限。

排队中任务响应

{
  "code": "SUCCESS",
  "msg": "操作成功",
  "result": {
    "taskId": "task_550e8400e29b41d4a71644665544000012345",
    "status": "QUEUED",
    "model": "doubao-seedance-2-0-260128",
    "createdAt": "2026-07-10 09:42:00",
    "requestId": "req_Kf82Lm90"
  }
}

处理中任务响应

{
  "code": "SUCCESS",
  "msg": "操作成功",
  "result": {
    "taskId": "task_550e8400e29b41d4a71644665544000012345",
    "status": "PROCESSING",
    "model": "doubao-seedance-2-0-260128",
    "createdAt": "2026-07-10 09:42:00",
    "requestId": "req_Kf82Lm90"
  }
}

成功任务响应

{
  "code": "SUCCESS",
  "msg": "操作成功",
  "result": {
    "taskId": "task_550e8400e29b41d4a71644665544000012345",
    "status": "SUCCEEDED",
    "model": "doubao-seedance-2-0-260128",
    "output": {
      "type": "VIDEO",
      "resultUrl": "https://example.com/result.mp4",
      "lastFrameUrl": "https://example.com/last-frame.png",
      "expiresAt": "2026-07-11 09:47:18"
    },
    "usage": {
      "inputTokens": 0,
      "outputTokens": 108900,
      "totalTokens": 108900
    },
    "billing": {
      "currency": "CNY",
      "chargeAmount": "10.01880000",
      "pricePerMillionTokens": "92.00000000"
    },
    "createdAt": "2026-07-10 09:42:00",
    "completedAt": "2026-07-10 09:47:18",
    "requestId": "req_Kf82Lm90"
  }
}

失败任务响应

{
  "code": "SUCCESS",
  "msg": "操作成功",
  "result": {
    "taskId": "task_550e8400e29b41d4a71644665544000012345",
    "status": "FAILED",
    "model": "doubao-seedance-2-0-260128",
    "error": {
      "code": "TASK_PROCESSING_FAILED",
      "message": "处理通道未能完成视频生成任务"
    },
    "createdAt": "2026-07-10 10:00:00",
    "completedAt": "2026-07-10 10:01:26",
    "requestId": "req_Pm31Rx72"
  }
}

已过期任务响应

{
  "code": "SUCCESS",
  "msg": "操作成功",
  "result": {
    "taskId": "task_550e8400e29b41d4a71644665544000012345",
    "status": "EXPIRED",
    "model": "doubao-seedance-2-0-260128",
    "error": {
      "code": "EXECUTION_TIMEOUT",
      "message": "任务超过执行截止时间"
    },
    "createdAt": "2026-07-10 10:10:00",
    "completedAt": "2026-07-12 10:10:00",
    "requestId": "req_Vn48Ct16"
  }
}

轮询建议

使用递增间隔轮询，避免高频请求。
QUEUED 和 PROCESSING 状态继续查询，终态后立即停止轮询。
按业务设置最长等待时间，但不要因此删除任务 ID。
记录 requestId，便于发生异常时定位请求链路。