# 创建字幕擦除任务

对已生成的视频做 AI 精细化字幕擦除，异步返回任务 ID。

**完成通知 —— 二选一**：
- 配 `callback_url` → 任务终态时 XRToken 主动 POST 通知你，无需轮询
- 不配 → 自行 `GET /v1/videos/erase-subtitle/{taskId}` 轮询结果

**输入约束**：只能擦除通过 XRToken 生成的视频，且生成时间
< 23 小时。调用方传 `video_task_id`，其他的 XRToken 处理。

**擦除耗时**：不排队情况下一般 20–30 分钟内完成；高峰排队时
可能延长到 2–3 小时。建议使用 `callback_url` 避免长轮询。

**支持擦除的字幕**：
- 垂直位置：画面 **下半部分** 的横向字幕
- 字号：单字竖向高度为视频高度的 **1% – 10%**
- 语言：中文 / 英文

**不支持**（以下情况不会被擦除）：
- 位于画面 **上半部分** 的字幕
- 字号过小（< 1% 高度）或过大（> 10% 高度）
- 中英文之外的语言 / 无法识别语种的文本

**可能误擦的场景**：画面下半部分出现的符合尺寸阈值的场景文本
（例如条幅、招牌文字）也会被识别为字幕一并擦除。建议调用方
在上游视频生成阶段就控制这类文本的出现位置。

**计费**：按视频秒数计费；当前免费推广期，每次调用产生 ¥0.00 的
消费记录（可在账单页查询）。擦除完成后，结果视频自动写入素材库，
与原视频并列展示。

## POST /v1/videos/erase-subtitle

> 创建字幕擦除任务

对已生成的视频做 AI 精细化字幕擦除，异步返回任务 ID。

**完成通知 —— 二选一**：
- 配 `callback_url` → 任务终态时 XRToken 主动 POST 通知你，无需轮询
- 不配 → 自行 `GET /v1/videos/erase-subtitle/{taskId}` 轮询结果

**输入约束**：只能擦除通过 XRToken 生成的视频，且生成时间
< 23 小时。调用方传 `video_task_id`，其他的 XRToken 处理。

**擦除耗时**：不排队情况下一般 20–30 分钟内完成；高峰排队时
可能延长到 2–3 小时。建议使用 `callback_url` 避免长轮询。

**支持擦除的字幕**：
- 垂直位置：画面 **下半部分** 的横向字幕
- 字号：单字竖向高度为视频高度的 **1% – 10%**
- 语言：中文 / 英文

**不支持**（以下情况不会被擦除）：
- 位于画面 **上半部分** 的字幕
- 字号过小（< 1% 高度）或过大（> 10% 高度）
- 中英文之外的语言 / 无法识别语种的文本

**可能误擦的场景**：画面下半部分出现的符合尺寸阈值的场景文本
（例如条幅、招牌文字）也会被识别为字幕一并擦除。建议调用方
在上游视频生成阶段就控制这类文本的出现位置。

**计费**：按视频秒数计费；当前免费推广期，每次调用产生 ¥0.00 的
消费记录（可在账单页查询）。擦除完成后，结果视频自动写入素材库，
与原视频并列展示。

### Authentication

`Authorization: Bearer tr-xxx`

### Request Body

Content-Type: `application/json`

- **video_task_id** `string` **(required)**  
  视频生成任务 ID —— 由 `POST /v1/videos/generations` 返回的
- **callback_url** `string`  
  可选。任务到达终态时（成功或失败）XRToken 会向该 URL 发起一次

### Response

- **id** `string` **(required)**  
  字幕擦除任务 ID（用于轮询状态）
- **upstream_id** `string`  
  上游 Volcengine 的任务 ID
- **status** ``processing`` **(required)**  
  
- **created_at** `string` **(required)**  
  

### Error Codes

- `400`: 
- `401`: 
- `402`: 
- `429`: 
- `502`: