视频字幕上传

更新时间：2019-6-28

1. 视频字幕抓取接口

接口描述
该接口用于以url的方式的上传字幕，用户需提供一个有效的srtUrl（适用于有可访问的字幕url但没有本地文件的用户）。
注：
1. 该接口字幕设置逻辑和admin系统保持一致，一个视频上传两个字幕时，字幕的相关设置以后一个字幕为准。
2. 一个视频上传双字幕时，本接口不支持并行请求，请串行请求。
请求地址
https://spark.bokecc.com/api/video/fetchsrt
请求方式
GET
请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。

名称 类型 必填 描述
userId String 是 用户ID。
videoId String 是 视频ID。
srtName String 是 字幕播放器上显示名称（最多四个字符）。
srtUrl String 是 字幕地址。
注：要上传的srtUrl必须是合法的URL，字幕文件为srt格式的字幕，否者会报参数异常或生成字幕文件异常。例：https://spark.bokecc.com/subtitle/test.srt。
srtNum Integer 否 字幕序号，双字幕时用来区分是第一个还是第二个字幕。(可选值1、2，默认值：1)。
注：一个视频第一次上传字幕srtNum只能为1。
fontFamily String 否 字幕字体（可选值：宋体、微软雅黑、楷体、黑体、隶书、andaleMono、impact、arical、NewRoman、NotoSans、OpenSans。默认值：NewRoman）。
fontSize Integer 否 字幕字体大小（默认值：20）。
fontColor String 否 字幕字体颜色（默认值：#FFFFFF）。
fontSurroundColor String 否 字幕字体环绕颜色（默认值为：#000000）。
marginBottom String 否 字幕距离底部的距离百分比（默认值：15%）。
fileEncode String 否 字幕的编码方式（可选值：utf-8、gbk。默认值：utf-8）。
请求示例
https://spark.bokecc.com/api/video/fetchsrt?srtUrl=https%3A%2F%2Fspark.bokecc.com%2Fsubtitle%2Ftest.srt&srtNum=1&videoId=6D080640AF53B5D363835A29B2A11xxx&userId=CC443A66867376xx&fontSurroundColor=%23000000&fontFamily=NewRoman&fileEncode=utf-8&fontSize=20&marginBottom=15%25&time=1671373007679&srtName=%E6%B5%8B%E8%AF%95%E5%AD%97%E5%B9%95&fontColor=%23FFFFFF&hash=78757F0A4E0AAFB604CF9BF897BA8135
返回示例
{
    "result": "OK"
}

2. 视频字幕上传接口

接口描述
该接口用于以本地文件的方式的上传字幕（适用于有字幕文件需要从本地上传字幕文件的用户）。
注：
1. 要上传的字幕文件格式为srt。
2. 一个视频第一次上传字幕时，srtNum只能为1。
3. 一个视频上传双字幕时，本接口不支持并行请求，请串行请求。
请求地址
https://spark.bokecc.com/api/video/srtupload
请求方式
POST/form-data
请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。字幕本地文件以文件流的方式传输即可。

名称 类型 必填 描述
userId String 是 用户ID。
videoId String 是 视频ID。
srtName String 是 字幕播放器上显示名称（最多四个字符）。
srtNum Integer 否 字幕序号，双字幕时用来区分是第一个还是第二个字幕。(可选值1、2，默认值：1)。
注：一个视频第一次上传字幕srtNum只能为1。
fontFamily String 否 字幕字体（可选值：宋体、微软雅黑、楷体、黑体、隶书、andaleMono、impact、arical、NewRoman、NotoSans、OpenSans。默认值：NewRoman）。
fontSize Integer 否 字幕字体大小（默认值：20）。
fontColor String 否 字幕字体颜色（默认值：#FFFFFF）。
fontSurroundColor String 否 字幕字体环绕颜色（默认值为：#000000）。
marginBottom String 否 字幕距离底部的距离百分比（默认值：15%）。
fileEncode String 否 字幕的编码方式（可选值：utf-8、gbk。默认值：utf-8）。
请求示例
https://spark.bokecc.com/api/video/srtupload?fontFamily=NewRoman&fileEncode=utf-8&srtNum=1&fontSize=20&marginBottom=15%25&videoId=6D080640AF53B5D3753C612EB38A8xxx&time=1671374342666&srtName=%E6%B5%8B%E8%AF%95%E5%AD%97%E5%B9%95&userId=CC443A6686737xxx&fontColor=%23FFFFFF&fontSurroundColor=%23000000&hash=2E49C9BD19DB95EFCD72FA0DBAC34C62
返回示例
{
    "result": "OK"
}

results matching ""

    No results matching ""