更新时间：2026-06-16 GMT+08:00
音视频处理接口 - ImediaHandle
功能介绍
音视频处理接口
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/aisaas/process/media
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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鉴权 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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 | 视频元数据信息 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 创建任务响应 |
父主题： AI_saas服务调用接口
