/volcengine/contents/generations/tasks/query

通过 POST 使用创建时返回的唯一 task_id 查询服务端保存的 Seedance 任务状态、视频结果和结算状态。

方法: POST 路径: /volcengine/contents/generations/tasks/query 扣费: 仅支持付费 API Key（无免费试用）

接口说明

查询请求必须使用创建该任务时相同的本项目 API Key，并将创建响应中的唯一 task_id 与 api_key 放在 JSON 请求体中。服务端负责排队、提交上游、callback 回写和轮询兜底；客户端只需持续查询此接口。status 为 succeeded 时，从 data.result.content.video_url 获取视频。

请求参数

字段 类型 必填 说明 示例
task_id string 是 创建任务接口返回的唯一公共任务 ID 0d0d7b0f-5bb3-4c4d-bbca-0d47c4f3bb86
api_key string 是 创建该任务时使用的本项目付费 API Key uk_live_xxx

调用示例

查询任务状态

curl -X POST "https://coze-js-api.devtool.uk/volcengine/contents/generations/tasks/query" \
  -H "Content-Type: application/json" \
  -d '{
    "task_id": "0d0d7b0f-5bb3-4c4d-bbca-0d47c4f3bb86",
    "api_key": "uk_live_xxx"
  }'

成功任务响应示例

{
  "code": 200,
  "msg": "查询视频生成任务成功",
  "data": {
    "task_id": "0d0d7b0f-5bb3-4c4d-bbca-0d47c4f3bb86",
    "status": "succeeded",
    "result": {
      "content": {
        "video_url": "https://example.com/generated-video.mp4"
      }
    }
  }
}

返回参数

字段路径 类型 说明
code number 200 表示已收到上游任务响应；-1 表示本地校验或上游调用失败
msg string 本地查询与结算提示；欠费任务会明确提示
data.status string queued、submitting、submitted、succeeded、failed 或 submit_unknown；非终态时继续查询
data.result.content.video_url string 仅成功任务出现：服务端保存的生成视频链接
data.reason string 仅失败或提交结果未知时出现：安全的失败原因
data.reservation object 预扣费及最终多退少补的结算状态

返回示例

{
  "code": 200,
  "msg": "查询视频生成任务成功",
  "data": {
    "task_id": "0d0d7b0f-5bb3-4c4d-bbca-0d47c4f3bb86",
    "status": "succeeded",
    "result": {
      "content": {
        "video_url": "https://example.com/generated-video.mp4"
      }
    }
  }
}