查询 Seedance 视频任务

查询任务状态。请求必须携带 Bearer API Key。建议轮询间隔不低于 10 秒，并在 completed 或 failed 后停止轮询。

状态含义：queued 排队中，in_progress 生成中，completed 已完成，failed 失败。成功时视频地址位于 metadata.url。

progress 是粗粒度状态，不是线性进度或剩余时间估算；任务可能长时间停留在同一个百分比。本次三参考图成功案例约 227 秒完成，期间曾长时间保持 progress=50。客户端等待超时不等于服务端任务失败，应继续查询原 task_id，不得通过重新创建任务来“续查”。

seconds、size 和 usage 等可选字段可能缺失或为 null。缺少 usage 不代表用量为 0，也不代表没有计费；统一查询和兼容查询都没有用量时，请以账户消费日志为准。

返回响应

🟢200成功

application/json

任务状态和生成结果。

Bodyapplication/json

示例

生成中生成完成生成失败

{
    "id": "task_01k2example",
    "task_id": "task_01k2example",
    "object": "video",
    "model": "doubao-seedance-2-0-260128",
    "status": "in_progress",
    "progress": 50,
    "created_at": 1786400000
}

🟠400请求有误

🟠401没有权限

🔴500服务器错误

查询 Seedance 视频任务

请求参数

请求示例代码

返回响应