# 获取视频字幕 - IGetVideoSubtitle
#### 功能介绍
获取视频字幕
#### 授权信息
当前API调用无需身份策略权限。
#### URI
GET /koodrive/ose/v1/subtitle
表1Query参数 
| 参数      | 是否必选 | 参数类型   | 描述           |
|:---|:---|:---|:---|
| videoId | 是    | String | 视频文件id       |
| lang    | 否    | String | 语言 枚举值是cn,en |
   
#### 请求参数
表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参数 
| 参数       | 参数类型                                                                                       | 描述   |
|:---|:---|:---|
| \[数组元素\] | Array of [GetVideoSubtitleResp] objects | 字幕响应 |
   
 表4GetVideoSubtitleResp 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| lang       | String | 字幕语言 |
| subtitleId | String | 字幕id |
   
**状态码：401**
表5响应Body参数 
| 参数   | 参数类型   | 描述   |
|:---|:---|:---|
| code | String | 状态码  |
| msg  | String | 状态描述 |
   
#### 请求示例
获取视频字幕
```
/koodrive/ose/v1/subtitle?videoId=Fk5QKjfjxxxROlxxxxx&lang=cn,en
GET /koodrive/ose/v1/subtitle?videoId=Fk5QKjfjxxxROlxxxxx&lang=cn,en
 
Authorization: Bearer+dsadasd*******4ad83c8f'
```
#### 响应示例
**状态码：200**
获取视频字幕响应成功
```
{
  "result" : [ {
    "subtitleId" : 1716573358981858600,
    "lang" : "en"
  }, {
    "subtitleId" : 1716573358981858600,
    "lang" : "cn"
  } ],
  "code" : 0,
  "msg" : "success"
}
```
#### 状态码
| 状态码 | 描述         |
|:---|:---|
| 200 | 获取视频字幕响应成功 |
| 401 | 鉴权失效       |