查询火山原生视频任务

使用同一账户的任一有效 API Key 查询原生任务状态、生成结果和实际元数据。

最后更新: 2026-08-31

本页内容

GET/api/v3/contents/generations/tasks/{id}

查询创建后七天内、属于当前账户的火山原生任务。

路径与请求头

参数	类型	要求	说明
`id`	string	必填	创建接口返回的 cgt-yyyyMMddHHmmss-xxxxx 任务编号。
`Authorization`	string	必填	Bearer <同一账户下任一有效 EaseRouter API Key>。

任务状态

status	含义	建议
queued	等待执行	继续轮询
running	正在提交、生成或等待结算	继续轮询
succeeded	生成成功	期限内读取 content.video_url；正文到期后 content 省略，成功状态与用量保留
failed	生成失败	读取顶层 error
expired	任务超过执行有效期	创建新任务

成功任务响应示例

{
  "id": "cgt-20260831123045-a1b2c",
  "model": "doubao-seedance-2-0-260128",
  "status": "succeeded",
  "created_at": 1788150645,
  "updated_at": 1788150728,
  "content": {
    "video_url": "https://result.example/video.mp4",
    "last_frame_url": "https://result.example/last-frame.png"
  },
  "seed": 184467,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": "11",
  "framespersecond": 24,
  "generate_audio": true,
  "service_tier": "default",
  "execution_expires_after": 172800,
  "usage": {
    "completion_tokens": 35800,
    "total_tokens": 35800
  }
}

失败任务响应示例

{
  "id": "cgt-20260831123045-a1b2c",
  "model": "doubao-seedance-2-0-260128",
  "status": "failed",
  "error": {
    "code": "OutputVideoSensitiveContentDetected",
    "message": "The output video was blocked by the content safety policy"
  },
  "created_at": 1788150645,
  "updated_at": 1788150728
}

同步错误格式

参数、鉴权、任务不存在、幂等冲突、额度不足及内部异常使用真实 HTTP 状态码，并返回顶层 error。常见状态为 400、401、404、409、429 和 500。

{
  "error": {
    "code": "InvalidParameter",
    "message": "Invalid request parameters",
    "param": "duration",
    "type": "BadRequest"
  }
}

HTTP 401：API Key 缺失、无效或已禁用。
HTTP 404：任务不存在、不属于当前账户或已超过七天查询期。
HTTP 409：同一 X-Request-Id 被用于不同创建载荷。
HTTP 429：账户额度或并发配额不足。
HTTP 500：未知内部异常；保留响应头 X-Request-Id 后联系支持。