有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

接口描述

接口名称:/Material/ProcessMaterial
接口功能:媒体处理,支持对视频类媒体发起 AI 识别或者字幕识别任务。

调用方式

具体调用方式参见 客户端 API 调用方式综述,您也可以使用 CME 客户端 API 调试工具 快速进行调试。

输入参数

字段
类型
必填
描述
MaterialId
String
要删除的媒体 ID 。
Definition
Integer
视频处理模板,取值:
20:发起全部 AI 任务(按帧标签、字幕、文本、物体、人物)。
30: 仅发起字幕识别任务。
VerifySign
String
接口签名,具体签名计算参考签名算法

输出参数

接口输出参数由 公共返回参数 和接口自身返回参数两部分组成。接口自身返回参数详情如下。
字段
类型
描述
TaskId
String
任务 ID。

示例

示例1:媒体处理成功

对 ID 为38192156030633420589媒体进行字幕识别,成功返回任务 ID。

输入示例

{
"MaterialId": "38192156030633420589",
"Definition": 20,
"VerifySign": "jMGDoS3N7l+kmdsuh5o6B9MXVuxjdXJyZW50VGltZVN0YW1wPxxxxxxxx"
}

输出示例

{
"Code": "Success",
"Message": "成功",
"EnglishMessage": "success",
"Data": {
"TaskId": "1810000001-procedurev2-a475c2318d5569d30a146ea723d292a2t0"
}
}

示例2:媒体处理失败

对 ID 为38192156030633420589媒体进行字幕识别,返回失败。

输入示例

{
"MaterialId": "38192156030633420589",
"Definition": 20,
"VerifySign": "jMGDoS3N7l+kmdsuh5o6B9MXVuxjdXJyZW50VGltZVN0YW1wPxxxxxxxx"
}

输出示例

{
"Code": "OperationDenied.PermissionDeny",
"Message": "权限不足",
"EnglishMessage": "permission denied"
}