# 请求获取视频字幕的OBS下载链接 - RequestVideoSubtitleObsUrl
#### 功能介绍
请求获取视频字幕的OBS下载链接
#### 授权信息
当前API调用无需身份策略权限。
#### URI
POST /koodrive/ose/v1/subtitle/requestObsUrl
表1Query参数 
| 参数           | 是否必选 | 参数类型   | 描述                              |
|:---|:---|:---|:---|
| 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 | 响应结果 |
   
 表4GetVideoSubtitleObsUrlInfo 
| 参数         | 参数类型   | 描述     |
|:---|:---|:---|
| 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"
}
```
#### 状态码
| 状态码 | 描述         |
|:---|:---|
| 200 | 字幕生成地址响应成功 |
| 401 | 鉴权失效       |