# 查询视频生成任务

URL: http://localhost:3000/docs/zh-cn/api/getSeedanceTask

本文介绍查询视频生成任务 API 的输入输出参数，供您使用接口时查阅字段含义。按任务 ID 查询任务的当前状态、实际生效的生成参数，以及生成成功后的视频地址。



只能查询当前 API Key 所属账号下的任务。响应结构与 `callback_url` 收到的通知一致。

## 任务状态 [#任务状态]

`status` 的取值与流转：

| 阶段 | 状态                                 | 说明                                 |
| -- | ---------------------------------- | ---------------------------------- |
| 检测 | `pending_review` → `review_passed` | 内容安全检测通过后进入排队                      |
|    | `review_blocked`                   | 未通过检测，任务终止                         |
| 生成 | `queued` → `running`               | 排队中 → 生成中                          |
| 终态 | `succeeded`                        | 生成成功，可取视频                          |
|    | `failed`                           | 生成失败，原因见 `error`                   |
|    | `cancelled`                        | 已取消                                |
|    | `expired`                          | 超过 `execution_expires_after` 设定的时间 |

进入终态后 `status` 不再变化。[创建任务](/zh-cn/api/createSeedanceTask)时填写了 `callback_url` 的，状态变化会异步推送到该地址，无需轮询本接口。

## 取回生成结果 [#取回生成结果]

`status` 为 `succeeded` 时，产出在 `content` 下：

| 字段                       | 说明                                          |
| ------------------------ | ------------------------------------------- |
| `content.video_url`      | 生成视频的下载地址                                   |
| `content.expiredAt`      | `video_url` 的过期时间，RFC3339 格式                |
| `content.last_frame_url` | 尾帧图像地址，仅在创建时设置 `return_last_frame=true` 时返回 |

<Callout type="warn" title="video_url 是带签名的临时地址">
  有效期至 `content.expiredAt`，即任务 `updated_at` 之后 24 小时，过期后失效。需要长期保存的视频请在有效期内转存至己方存储，不要直接把该地址存库或分发给终端用户。
</Callout>

## 接口详情 [#接口详情]

<OpenAPIPage document="public" operations="[{&#x22;path&#x22;:&#x22;/api/v3/contents/generations/tasks/{id}&#x22;,&#x22;method&#x22;:&#x22;get&#x22;}]" />


---

本页对应接口：`GET /api/v3/contents/generations/tasks/{id}`。机器可读的完整 schema：

- 本接口 schema：http://localhost:3000/docs/openapi/operations/getSeedanceTask.zh.json
- 完整对外 spec（供代码生成工具使用）：http://localhost:3000/docs/openapi/public.zh.json