# 修改视频字幕 - UpdateVideoSubtitle
#### 功能介绍
修改视频字幕，修改任意一种字幕后，字幕内容（不包含各格式的自定义样式）会同步到其他格式的产物中
#### 授权信息
当前API调用无需身份策略权限。
#### URI
POST /koodrive/ose/v1/subtitle/edit
#### 请求参数
表1请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| Authorization | 是    | String | 鉴权头                                                                                                                                                                                                                          |
| X-Date        | 是    | String | 参数解释：签名时间，用于appId鉴权 约束限制：距当前时间15分钟以内，不能晚于当前时间 取值范围：日期格式，yyyMMdd'T'HHmmss'Z'，例：20251103T070140Z 默认取值：不涉及 |
| X-AIUser-Id   | 否    | String | 参数解释：用户id，用于appId鉴权 约束限制：与X-User-Id必选其一，都存在时以X-AIUser-Id的值为准 取值范围：不涉及 默认取值：不涉及                          |
   
表2请求Body参数 
| 参数           | 是否必选 | 参数类型                                                                      | 描述                                                               |
|:---|:---|:---|:---|
| videoId      | 是    | String                                                                    | 视频ID                                                             |
| subtitleId   | 是    | String                                                                    | 字幕ID                                                             |
| subtitleType | 是    | String                                                                    | 字幕类型，枚举值SRT，VTT，ASS                                              |
| contentList  | 否    | Array of [contentList] objects | 修改的字幕内容列表，最大长度为500                                               |
| styles       | 否    | String                                                                    | VTT、ASS使用；若字幕格式为VTT，则替换STYLE的内容，若字幕格式为ASS，则替换 \[V4+ Styles\]内的内容 |
   
 表3contentList 
| 参数       | 是否必选 | 参数类型    | 描述                                                                                                                                                                     |
|:---|:---|:---|:---|
| index    | 是    | Integer | 字幕序号                                                                                                                                                                   |
| editType | 是    | Integer | 编辑类型：0 修改 ；1 插入 ；2 删除                                                                                                                                                  |
| start    | 否    | String  | 开始时间 "00:00:01.000", 约束：格式HH:MM:SS.mmm (HH: 00-99, MM: 00-59, SS: 00-59, mmm: 000-999)；对于字幕为HH:MM:SS.CS格式的会舍弃最后一位精度，即精度为CS（厘秒 ） |
| end      | 否    | String  | 结束时间 "00:00:04.000" 约束：格式HH:MM:SS.mmm (HH: 00-99, MM: 00-59, SS: 00-59, mmm: 000-999)；对于字幕为HH:MM:SS.CS格式的会舍弃最后一位精度，即精度为CS（厘秒 ）  |
| text     | 否    | String  | 字幕内容                                                                                                                                                                   |
| layer    | 否    | Integer | ASS格式专属，图层                                                                                                                                                             |
| style    | 否    | String  | ASS格式专属，样式名                                                                                                                                                            |
| name     | 否    | String  | ASS格式专属，说话人                                                                                                                                                            |
| marginL  | 否    | Integer | ASS格式专属，左边距                                                                                                                                                            |
| marginR  | 否    | Integer | ASS格式专属，右边距                                                                                                                                                            |
| marginV  | 否    | Integer | ASS格式专属，垂直边距                                                                                                                                                           |
| effect   | 否    | String  | ASS格式专属，特效                                                                                                                                                             |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数   | 参数类型                                               | 描述       |
|:---|:---|:---|
| code | String                                             | 状态码      |
| msg  | String                                             | 状态描述     |
| data | [data] object | 修改字幕响应数据 |
   
 表5data 
| 参数       | 参数类型                                                                 | 描述                |
|:---|:---|:---|
| failList | Array of [failList] objects | 更新失败列表。如果都成功则无需返回 |
   
 表6failList 
| 参数        | 参数类型   | 描述                        |
|:---|:---|:---|
| editPart  | String | 更新部分，content 、styles      |
| index     | String | 字幕序号，当更新部分=content 时，需要返回 |
| errorCode | String | 错误码                       |
| errorMsg  | String | 错误描述                      |
   
#### 请求示例
```
/koodrive/ose/v1/subtitle/edit
{
  "videoId" : "1959389459388617728",
  "subtitleId" : "1959389781578466177",
  "subtitleType" : "SRT",
  "contentList" : [ {
    "index" : 1,
    "editType" : 0,
    "start" : "00:00:01.300",
    "end" : "00:00:03.400",
    "text" : "1"
  }, {
    "index" : 300,
    "editType" : 0,
    "start" : "00:00:11.300",
    "end" : "00:00:13.400",
    "text" : "300"
  } ]
}
```
#### 响应示例
**状态码：200**
修改视频字幕响应
```
{
  "data" : {
    "failList" : [ {
      "editPart" : "content",
      "index" : 300,
      "errorCode" : "25000240",
      "errorMsg" : "Subtitle index not found"
    } ]
  },
  "code" : 0,
  "msg" : "success"
}
```
#### 状态码
| 状态码 | 描述       |
|:---|:---|
| 200 | 修改视频字幕响应 |