请求获取视频字幕的OBS下载链接 - RequestVideoSubtitleObsUrl

功能介绍

请求获取视频字幕的OBS下载链接

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/subtitle/requestObsUrl

表1 Query参数
参数	是否必选	参数类型	描述
videoId	是	String	视频文件id
lang	否	String	语言。枚举值是cn和en，可传参en\|cn\|cn,en
subtitleType	否	String	字幕文件类型。枚举值是VTT、SRT、ASS，不传返回全部类型
subtitleId	否	String	字幕文件ID

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
Authorization	是	String	鉴权头
X-Date	是	String	参数解释：签名时间，用于appId鉴权约束限制：距当前时间15分钟以内，不能晚于当前时间取值范围：日期格式，yyyMMdd'T'HHmmss'Z'，例：20251103T070140Z 默认取值：不涉及
X-User-Id	是	String	用户id，不用于appId鉴权
language	否	String	国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语
X-AIUser-Id	否	String	用户id，用于appId鉴权，与X-User-Id必选其一，都存在时以X-AIUser-Id的值为准

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
code	Integer	错误码
msg	String	错误信息
result	Array of GetVideoSubtitleObsUrlInfo objects	响应结果

表4 GetVideoSubtitleObsUrlInfo
参数	参数类型	描述
lang	String	字幕语言
url	String	字幕下载地址
subtitleId	String	字幕ID

状态码：401

表5 响应Body参数
参数	参数类型	描述
code	String	状态码
msg	String	状态描述

请求示例

获取视频字幕obs下载地址

/koodrive/ose/v1/subtitle/requestObsUrl?videoId=Fk5QKjfjxxxROlxxxxx&lang=cn,en

POST /koodrive/ose/v1/subtitle/requestObsUrl?videoId=Fk5QKjfjxxxROlxxxxx&lang=cn,en&subtitleId=id1
 
Authorization: Bearer+dsadasd*******4ad83c8f'

响应示例

状态码：200

字幕生成地址响应成功

{
  "result": [
    {
      "lang": "en",
      "subtitleId":"id1"
      "url": "https://obs-koodrive-ai.obs.cn-north-4.*****.com/koodriveai%2Fsubtitle%2Ftenants35_test%2F1716087922584894337%2FFtUx6HsL197lB7oqgm-1Py6Kcvv7J9qa5%2Fsubtitle_en_1754295435553.vtt?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=HPUA1TI53C2TRM9BJTSA%2F20250804%2Fregion%2Fs3%2Faws4_request&X-Amz-Date=20250804T081716Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3Bfilename%3Dsubtitle_en_1754295435553.vtt&X-Amz-Signature=78f052cc56da23201397a89905229a26a3d65f22454a4667e7c148dd97ad553a"
    },
    {
      "lang": "cn",
      "subtitleId":"id2"
      "url": "https://obs-koodrive-ai.obs.cn-north-4.*****..com/koodriveai%2Fsubtitle%2Ftenants35_test%2F1716087922584894337%2FFtUx6HsL197lB7oqgm-1Py6Kcvv7J9qa5%2Fsubtitle_cn_1754295436105.vtt?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=HPUA1TI53C2TRM9BJTSA%2F20250804%2Fregion%2Fs3%2Faws4_request&X-Amz-Date=20250804T081716Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3Bfilename%3Dsubtitle_cn_1754295436105.vtt&X-Amz-Signature=52f936752cf76f0e2b5303fa5667b83e92bc0841824641390f78c266fdc457ce"
    }
  ],
  "code": 0,
  "msg": "success"
}