# 查询字幕擦除任务状态

查询字幕擦除任务状态。

- **processing**：处理中，建议每 3–5 秒轮询一次。
- **succeeded**：擦除完成，`video_url` 字段包含结果视频下载链接。
- **failed**：处理失败，`error` 字段包含错误信息，冻结金额自动退还。

## GET /v1/videos/erase-subtitle/{taskId}

> 查询字幕擦除任务状态

查询字幕擦除任务状态。

- **processing**：处理中，建议每 3–5 秒轮询一次。
- **succeeded**：擦除完成，`video_url` 字段包含结果视频下载链接。
- **failed**：处理失败，`error` 字段包含错误信息，冻结金额自动退还。

### Authentication

`Authorization: Bearer tr-xxx`

### Path Parameters

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

### Response

- **id** `string` **(required)**  
  
- **status** ``processing` | `succeeded` | `failed` | `cancelled`` **(required)**  
  任务状态
- **video_url** `string`  
  擦除完成后的视频下载 URL，仅当 `status: succeeded` 时有值
- **result** `object`  
  上游返回的完整结果，仅当 `status: succeeded` 时有值
- **result.video_url** `string`  
  
- **error** `string`  
  错误信息，仅当 `status: failed` 时有值
- **created_at** `string` **(required)**  
  
- **updated_at** `string` **(required)**  
  

### Error Codes

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