# 生成VTT格式的字幕 - IGenerateVideoSubtitle
#### 功能介绍
生成VTT格式的字幕
#### 授权信息
当前API调用无需身份策略权限。
#### URI
GET /koodrive/ose/v1/subtitle/generate
表1Query参数 
| 参数         | 是否必选 | 参数类型   | 描述                   |
|:---|:---|:---|:---|
| videoId    | 是    | String | 视频文件id               |
| lang       | 是    | String | 语言, 仅支持输入一种语言(cn,en) |
| 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参数 
| 参数   | 参数类型 | 描述   |
|:---|:---|:---|
| file | File | 字幕文件 |
   
**状态码：401**
表4响应Body参数 
| 参数   | 参数类型   | 描述   |
|:---|:---|:---|
| code | String | 状态码  |
| msg  | String | 状态描述 |
   
#### 请求示例
生成VTT格式的字幕请求体
```
/koodrive/ose/v1/subtitle/generate
GET /koodrive/ose/v1/subtitle/generate?videoId=Fk5QKjfjMRV93gqHxxxx&lang=en&subtitle_id=190283
```
#### 响应示例
**状态码：200**
VTT格式的字幕内容响应成功
```
"WEBVTT
1
00:00:01.320 --> 00:00:03.390
我在哪里？
2
00:00:05.320 --> 00:00:06.740
这么多，到底是什么？
3
00:00:11.224 --> 00:00:12.352
那我就直说了。
4
00:00:13.724 --> 00:00:14.682
我八岁了"
```
#### 状态码
| 状态码 | 描述             |
|:---|:---|
| 200 | VTT格式的字幕内容响应成功 |
| 401 | 鉴权失效           |