# 查询视频生成任务状态

轮询视频生成任务的当前状态。

- **queued**：排队中，请继续轮询（建议间隔 5-10 秒）。
- **processing**：生成中，请继续轮询。
- **succeeded**：生成成功，`video_url` 字段包含可下载的视频链接（24 小时内有效）。
- **failed**：生成失败，`error` 字段包含错误信息，已冻结金额会自动退还。
- **expired**：任务超时（超过 `execution_expires_after` 设定时间）。
- **cancelled**：任务已取消（通过 DELETE 接口取消排队中的任务）。

任务记录保存 7 天，超时后自动清除。

## GET /v1/videos/generations/{taskId}

> 查询视频生成任务状态

轮询视频生成任务的当前状态。

- **queued**：排队中，请继续轮询（建议间隔 5-10 秒）。
- **processing**：生成中，请继续轮询。
- **succeeded**：生成成功，`video_url` 字段包含可下载的视频链接（24 小时内有效）。
- **failed**：生成失败，`error` 字段包含错误信息，已冻结金额会自动退还。
- **expired**：任务超时（超过 `execution_expires_after` 设定时间）。
- **cancelled**：任务已取消（通过 DELETE 接口取消排队中的任务）。

任务记录保存 7 天，超时后自动清除。

### Authentication

`Authorization: Bearer tr-xxx`

### Path Parameters

- **taskId** `string` **(required)**  
  任务 ID（由 `POST /v1/videos/generations` 返回的 `id` 字段）

### Response

- **id** `string` **(required)**  
  平台内部任务 ID
- **model** `string` **(required)**  
  使用的模型 ID
- **status** ``queued` | `processing` | `succeeded` | `failed` | `expired` | `cancelled`` **(required)**  
  任务状态
- **video_url** `string`  
  生成视频的下载 URL（24 小时内有效），仅当 `status: succeeded` 时有值
- **last_frame_url** `string`  
  视频尾帧图像 URL（png，24 小时内有效）。仅当创建任务时 `return_last_frame: true` 且 `status: succeeded` 时返回
- **duration** `integer`  
  生成视频的时长（秒）。与 `frames` 二选一返回
- **frames** `integer`  
  生成视频的帧数。仅当创建任务时指定了 `frames` 参数时返回（与 `duration` 二选一）
- **resolution** `string`  
  生成视频的分辨率
- **ratio** `string`  
  生成视频的宽高比
- **seed** `integer`  
  本次请求实际使用的随机种子值
- **generate_audio** `boolean`  
  生成的视频是否包含同步音频（仅 Seedance 2.0、1.5 pro 返回）
- **service_tier** `string`  
  实际使用的服务等级
- **draft** `boolean`  
  是否为 Draft 样片视频（仅 Seedance 1.5 pro 返回）
- **usage** `object`  
  本次请求的 token 用量，仅当 `status: succeeded` 时有值
- **usage.completion_tokens** `integer`  
  模型输出视频消耗的 token 数
- **usage.total_tokens** `integer`  
  总 token 数（视频生成模型不统计输入 token，故 total = completion）
- **error** `object`  
  错误信息，仅当 `status: failed` 时有值
- **error.code** `string`  
  错误码
- **error.message** `string`  
  错误描述
- **result** `object`  
  上游服务商的完整原始响应数据，仅当 `status: succeeded` 时有值
- **created_at** `string` **(required)**  
  任务创建时间
- **updated_at** `string` **(required)**  
  任务最后更新时间

### Error Codes

- `401`: 
- `404`: 任务不存在或不属于当前用户
- `429`: