
# 音视频处理接口 - ImediaHandle
#### 功能介绍
音视频处理接口
#### 授权信息
当前API调用无需身份策略权限。
#### URI
POST /koodrive/ose/v1/aisaas/process/media
#### 请求参数
表1请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| Authorization | 是    | String | 鉴权头                                                                                                                                                                                                     |
| X-Date        | 是    | String | 参数解释：签名时间，用于appId鉴权 约束限制：距当前时间15分钟以内，不能晚于当前时间 取值范围：日期格式，yyyMMdd'T'HHmmss'Z'，例：20251103T070140Z 默认取值：不涉及 |
| X-AIUser-Id   | 否    | String | 参数解释：用户id，用于appId鉴权 约束限制：与X-User-Id必选其一，都存在时以X-AIUser-Id的值为准 取值范围：不涉及 默认取值：不涉及                          |
| X-User-Id     | 否    | String | 用户id，不用于appId鉴权                                                                                                                                                                                         |
   
表2请求Body参数 
| 参数             | 是否必选 | 参数类型                                                         | 描述                            |
|:---|:---|:---|:---|
| downloadUrl    | 否    | String                                                       | 音视频地址链接                       |
| taskId         | 否    | String                                                       | 任务ID，32位随机字符串                 |
| expiredAt      | 否    | Number                                                       | 视频下载地址失效时间，毫秒时间戳              |
| subtitle       | 否    | String                                                       | 支持传入中英文的SRT/VTT/ASS格式字幕文件地址链接 |
| subtitleSuffix | 否    | String                                                       | 字幕文件后缀，SRT/VTT/ASS            |
| taskType       | 是    | Number                                                       | 任务类型                          |
| mediaType      | 是    | Number                                                       | 文件类型，0:视频 1:音频                |
| fileSuffix     | 是    | String                                                       | 文件后缀                          |
| subType        | 否    | Number                                                       | 任务子类型                         |
| extInfo        | 否    | String                                                       | 拓展字段                          |
| language       | 否    | String                                                       | 目标语言                          |
| videoMetaInfo  | 否    | [VideoMetaInfo] object | 视频元数据信息                       |
   
 表3VideoMetaInfo 
| 参数         | 是否必选 | 参数类型   | 描述   |
|:---|:---|:---|:---|
| createTime | 否    | String | 创建时间 |
| shotTime   | 否    | String | 拍摄时间 |
| address    | 否    | String | 拍摄地址 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数     | 参数类型   | 描述   |
|:---|:---|:---|
| taskId | String | 任务ID |
   
#### 请求示例
创建ai任务
```
/koodrive/ose/v1/aisaas/process/media
{
  "downloadUrl" : "https**********3D",
  "expiredAt" : 10,
  "taskType" : 3,
  "fileSuffix" : "mp4",
  "mediaType" : "1"
}
```
#### 响应示例
**状态码：200**
创建任务响应
```
{
  "taskId" : "172*****760",
  "code" : 0,
  "msg" : "success"
}
```
#### 状态码
| 状态码 | 描述     |
|:---|:---|
| 200 | 创建任务响应 |
   
