提交AI作业_视频AI_服务端API

描述

提交AI作业。作业在提交成功后会异步执行，不保证接口返回时作业已处理完成。

请注意：只有开通相关的AI服务后，才能调用此接口，详情参考视频AI介绍。

请求参数

名称	类型	必填项	描述
Action	String	是	操作接口名。系统规定参数，取值：SubmitAIJob
Types	String	是	AI作业类型，多个用逗号分隔。取值范围： AIMediaDNA（视频DNA） AIVideoTag（多模态内容理解）
MediaId	String	是	视频ID。
Config	String	否	作业配置，Json格式。具体结构定义参见AIConfig

Config的示例如下：
{
    "AIVideoTagConfig": {
        "AnalyseTypes": "Face,ASR"
    }
}
注意：

视频存储在上海或北京区域的，Face,ASR,OCR,Category,Annotation五种类型都支持
视频存储在其他区域的，暂不支持该服务

关于存储区域的说明，请见点播中心和访问域名>接入地址和存储区域。

AI作业配置 AIConfig

字段名	类型	必填项	取值
AIVideoTagConfig	AIVideoTagConfig	否	多模态内容理解作业配置

多模态内容理解作业配置 AIVideoTagConfig

字段名	类型	必填项	取值
AnalyseTypes	String	否	多模态内容理解的具体类型。可为多值，值之间用英文逗号隔开。该字段不填时默认分析所有类型取值范围： Face（人物） ASR（语音识别文本） OCR（文本识别） Category（分类） Annotation（实体标签）
OrigASRData	Boolean	否	是否返回ASR原始结果数据。该字段不填时不返回ASR原始结果。取值范围： true（返回） false（不返回）

字段名

类型

必填项

取值

AnalyseTypes

String

否

多模态内容理解的具体类型。

可为多值，值之间用英文逗号隔开。
该字段不填时默认分析所有类型

取值范围：

Face（人物）
ASR（语音识别文本）
OCR（文本识别）
Category（分类）
Annotation（实体标签）

OrigASRData

Boolean

否

是否返回ASR原始结果数据。该字段不填时不返回ASR原始结果。取值范围：

true（返回）
false（不返回）

返回参数

名称	类型	必填项	描述
RequestId	String	是	请求ID
AIJobList	AIJob[]	是	AI作业信息列表

AI作业 AIJob

字段名	类型	必填项	取值
JobId	String	是	作业ID
MediaId	String	是	视频ID
Type	String	是	作业类型

API示例

请求示例

http://vod.cn-shanghai.aliyuncs.com/?Action=SubmitAIJob&MediaId=3D3D12340d92c641401fab46a0b847xxxxxx&Types=AIVideoTag&Format=JSON&<公共参数>

注意：示例中的“公共参数”参见公共参数说明文档。

返回示例

{
    "RequestId": "25818875-5F78-4A13-BEF6-D73936XXXXXX",
    "AIJobList": {
        "AIJob": [
            {
                "JobId": "9e82640c85114bf5af23edfafxxxxxx",
                "MediaId":"3D3D12340d92c641401fab46a0b847xxxxxx",
                "Type":"AIVideoTag"
            }
        ]
    }
}

SDK示例

建议使用服务端SDK 来调用API，此API各语言调用的示例代码，请参考如下：