修改视频字幕 - 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	修改的字幕内容列表
styles	否	String	VTT、ASS使用；若字幕格式为VTT，则替换STYLE的内容，若字幕格式为ASS，则替换 [V4+ Styles]内的内容

表3 contentList
参数	是否必选	参数类型	描述
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	修改字幕响应数据

表5 data
参数	参数类型	描述
failList	Array of failList objects	更新失败列表。如果都成功则无需返回

表6 failList
参数	参数类型	描述
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" : 999,
    "editType" : 0,
    "start" : "00:00:11.300",
    "end" : "00:00:13.400",
    "text" : "999"
  } ]
}

响应示例

状态码：200

修改视频字幕响应

{
  "data" : {
    "failList" : [ {
      "editPart" : "content",
      "index" : 999,
      "errorCode" : "25000240",
      "errorMsg" : "Subtitle index not found"
    } ]
  },
  "code" : 0,
  "msg" : "success"
}