字幕处理 API
源语言与翻译后 SRT 字幕的获取、覆盖更新,以及批量设置字幕区域的接口
字幕处理 API
字幕接口覆盖翻译流程中与字幕相关的操作:
- 字幕区域:建议在 开始翻译 之前设置,用于限定 OCR 字幕检测范围;
- 源字幕:校准(review)阶段完成后可获取,可覆盖更新;
- 翻译后字幕:翻译(translate)阶段完成后可获取,可覆盖更新。
批量设置字幕区域
GET /project/video/subtitleRegion/save.html
批量更新所选视频的字幕区域配置。建议在开始翻译前设置,影响 OCR 字幕检测范围。
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| ids | query | arraystring | 是 | 视频 id 列表 |
| regions | query | string | 是 | 字幕区域(JSON 格式,存储相对坐标) |
返回示例
200 Response
{
"id": "string",
"code": 0,
"msg": "string",
"data": {}
}
返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | BaseReturnModel |
获取源字幕
GET /project/video/getSrt.html
获取视频的源语言 SRT 字幕全文。校准阶段完成后可调用。
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| id | query | string | 是 | 视频 id |
返回示例
200 Response
{
"id": "string",
"code": 0,
"msg": "string",
"data": {}
}
返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | BaseReturnModel |
获取翻译后字幕
GET /project/video/getTranslateSrt.html
获取视频的翻译后 SRT 字幕全文。翻译阶段完成后可调用。
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| id | query | string | 是 | 视频 id |
返回示例
200 Response
{
"id": "string",
"code": 0,
"msg": "string",
"data": {}
}
返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | BaseReturnModel |
更新源字幕
GET /project/video/updateSourceSrt.html
覆盖更新视频的源 SRT 字幕全文。
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| id | query | string | 是 | 视频 id |
| sourceText | query | string | 是 | 源字幕 SRT 全文 |
返回示例
200 Response
{
"id": "string",
"code": 0,
"msg": "string",
"data": {}
}
返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | BaseReturnModel |
更新翻译后字幕
GET /project/video/updateTranslateSrt.html
覆盖更新视频的翻译后 SRT 字幕全文。
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| id | query | string | 是 | 视频 id |
| translateText | query | string | 是 | 翻译后字幕 SRT 全文 |
返回示例
200 Response
{
"id": "string",
"code": 0,
"msg": "string",
"data": {}
}
返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | BaseReturnModel |