全部产品
云市场

提交AI作业

更新时间:2019-09-03 14:44:54

描述

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

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

请求参数

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

Config的示例如下:

  1. {
  2. "AIVideoTagConfig": {
  3. "AnalyseTypes": "Face,ASR"
  4. }
  5. }

注意:

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

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

AI作业配置 AIConfig

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

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

字段名 类型 必填项 取值
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示例

请求示例

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

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

返回示例

  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D73936XXXXXX",
  3. "AIJobList": {
  4. "AIJob": [
  5. {
  6. "JobId": "9e82640c85114bf5af23edfafxxxxxx",
  7. "MediaId":"3D3D12340d92c641401fab46a0b847xxxxxx",
  8. "Type":"AIVideoTag"
  9. }
  10. ]
  11. }
  12. }

SDK示例

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