# 查询字幕擦除任务状态

查询字幕擦除任务状态。

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

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

> Query subtitle erase task status

Query subtitle erase task status.

- **processing**: In progress. Recommended polling interval: 3-5 seconds.
- **succeeded**: Erase complete. `video_url` contains the result download link.
- **failed**: Processing failed. `error` contains the error message; the frozen amount is refunded automatically.

### Authentication

`Authorization: Bearer tr-xxx`

### Path Parameters

- **taskId** `string` **(required)**  
  Task ID (the `id` field returned by `POST /v1/videos/erase-subtitle`)

### Response

- **id** `string` **(required)**  
  
- **status** ``processing` | `succeeded` | `failed` | `cancelled`` **(required)**  
  Task status
- **video_url** `string`  
  Erased video download URL, present only when `status: succeeded`
- **result** `object`  
  Full upstream result, present only when `status: succeeded`
- **result.video_url** `string`  
  
- **error** `string`  
  Error message, present only when `status: failed`
- **created_at** `string` **(required)**  
  
- **updated_at** `string` **(required)**  
  

### Error Codes

- `401`: 
- `404`: Task not found or does not belong to the current user
- `429`: