# 视频任务与下载

<a id="video-status"></a>

<a id="查询视频状态"></a>

### 查询视频状态

`GET /v1/videos/{id}`

状态通常按 `queued → in_progress → completed` 变化，也可能进入 `failed`。只有完成后才能读取视频内容。

<a id="video-content"></a>

<a id="下载视频"></a>

### 下载视频

`GET /v1/videos/{id}/content`

完成任务后返回  **mp4 原始二进制** ，不是 Base64，也不是 JSON。任务未完成时返回 409。

<a id="video-response"></a>

## 结果返回方式

创建、轮询、下载分为三步。显式传 `response_format: "url"` 时完成态包含 `url` 和 `expires_at`；否则使用 `/content`。