提交智能标签作业接口,作业是异步执行方式,作业添加到管道中调度排队和执行。可以调用“查询智能标签作业”接口查询作业执行结果,也可以使用异步的消息通知机制。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:SubmitSmarttagJob
Input String 需要分析的视频或图片文件地址, 图片文件支持jpg、jpeg、png三种类型(按文件后缀名校验)。
说明 MPS目前只支持OSS文件地址,例如:oss://[bucket]/[object_path]。
举例如下:
  • oss://mybucket/test.mp4
  • oss://testbucket/videos/2020/1.mp4
注意 oss bucket所在区域必须与调用openapi所在的区域相同,mps从用户bucket拉取视频或图片免流量费用。
PipelineId String 管道ID,用于区分业务,绑定消息通知。可填空,表示默认管道。默认管道并发为2,需要提升并发数请提交工单
说明 管道目前仅支持后台创建,相关查询、更新接口请参见更新管道
Title String 视频标题,长度不能超过256B。
Content Content 视频内容描述,长度不能超过1KB。
TemplateId String 模板ID用于指定分析算法,模板相关操作参见添加模板查询模板更新模板删除模板。不填写模板ID时,默认调用所有分析算法。
Params String 额外的请求参数,使用Json字符串表示,形如:{"needAsrData":true, "needOcrData":false}。字段说明:
  • needAsrData:boolean值,分析结果中是否需要包含原始asr结果,默认false
  • needOcrData:boolean值,分析结果中是否需要包含原始ocr结果,默认false
UserData String 通过MNS回调时透传回来的信息,长度不能超过1KB。如何设置MNS回调队列,请参见更新管道

返回参数

名称 类型 描述
JobId String 智能标签任务ID

返回错误码

异常错误码 描述
MissingParameterd 输入缺少必要参数。

示例

  • 请求示例
    http://mts.cn-shanghai.aliyuncs.com/?Action=SubmitSmarttagJob&Input=oss://testbucket/example.flv&Title=test-video&<公共参数>
  • 返回示例
    • XML格式
      <SubmitMediaCensorJobResponse>
          <RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
          <JobId>88c6ca184c0e47098a5b665e2a126797</JobId>
      </SubmitCensorJobResponse>
    • JSON格式
      {
          "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
          "JobId": "88c6ca184c0e47098a5b665e2a126797"
      }

SDK示例