查询状态

请求地址

GET /v1/video/generations/{id}

状态值

统一查询接口的 data.status 使用大写任务状态：

状态	说明
NOT_START、SUBMITTED、QUEUED	排队中
IN_PROGRESS	生成中
SUCCESS	已完成
FAILURE	执行失败，失败原因见 data.fail_reason

部分模型的官方兼容路径（如 Seedance 的 /api/v3/contents/generations/tasks/{id}）使用小写状态 queued / running / succeeded / failed，对应关系见各模型文档。

响应字段

统一查询接口返回任务状态、结果地址、计费额度和可公开的模型信息。部分视频服务商会在任务完成后返回 token 用量；当平台可以获取到该数据时，响应会包含 usage 字段。

字段	说明
data.task_id	任务 ID
data.status	任务状态
data.progress	任务进度
data.result_url	任务完成后的视频地址
data.fail_reason	任务失败时的失败原因
data.quota	本次任务消耗的系统额度
data.properties.origin_model_name	用户请求的公开模型名
data.usage.prompt_tokens	输入 token 数；视频服务商未返回时为 0 或省略整个 usage
data.usage.completion_tokens	输出/生成 token 数
data.usage.total_tokens	总 token 数

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_xxx",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://example.com/video.mp4",
    "quota": 5635575,
    "properties": {
      "prompt": "视频生成提示词",
      "origin_model_name": "doubao-seedance-2.0"
    },
    "usage": {
      "prompt_tokens": 0,
      "completion_tokens": 731025,
      "total_tokens": 731025
    }
  }
}