/volcengine/contents/generations/tasks/query

通过 POST 查询 Seedance 视频生成任务状态；成功后获取视频链接、上游用量和本地结算状态。

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

接口说明

查询请求必须使用创建该任务时相同的本项目 API Key，并将 task_id 与 api_key 都放在 JSON 请求体中。任务处于非终态时可继续轮询；status 为 succeeded 时，从 data.content.video_url 获取视频。若返回 settlement，charged 表示已结算，outstanding 表示视频已返回但该任务仍有欠费，pending 表示结算正在处理。

请求参数

字段	类型	必填	说明	示例
`task_id`	string	是	创建任务接口返回的任务 ID	`cgt-20260717225350-4qbw4`
`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": "cgt-20260717225350-4qbw4",
    "api_key": "uk_live_xxx"
  }'

成功任务响应示例

{
  "code": 200,
  "msg": "查询视频生成任务成功",
  "data": {
    "id": "cgt-20260717225350-4qbw4",
    "status": "succeeded",
    "content": {
      "video_url": "https://example.com/generated-video.mp4"
    },
    "usage": {
      "completion_tokens": 35800
    }
  },
  "settlement": {
    "status": "charged",
    "credits": 43
  }
}

返回参数

字段路径	类型	说明
`code`	number	200 表示已收到上游任务响应；-1 表示本地校验或上游调用失败
`msg`	string	本地查询与结算提示；欠费任务会明确提示
`data.status`	string	上游任务状态；succeeded 为成功，failed 为失败，其他状态应继续轮询
`data.content.video_url`	string	仅成功任务出现：生成视频的上游访问链接
`data.error`	object	仅失败任务出现：上游错误对象
`data.usage.completion_tokens`	number	仅成功任务出现：上游返回的完成 token 用量
`settlement.status`	string	仅完成且有有效用量的任务出现：charged、outstanding 或 pending
`settlement.credits`	number	该任务的最终扣除积分

返回示例

{
  "code": 200,
  "msg": "查询视频生成任务成功",
  "data": {
    "id": "cgt-20260717225350-4qbw4",
    "status": "succeeded",
    "content": {
      "video_url": "https://example.com/generated-video.mp4"
    },
    "usage": {
      "completion_tokens": 35800
    }
  },
  "settlement": {
    "status": "charged",
    "credits": 43
  }
}