文档首页/ 云空间服务 KooDrive/ API参考/ API/ AI_saas服务调用接口/ 音视频处理接口 - ImediaHandle
更新时间：2026-06-16 GMT+08:00
查看PDF
分享

音视频处理接口 - 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

视频元数据信息
表3 VideoMetaInfo

参数

是否必选

参数类型

描述

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

创建任务响应

相关文档