调用SubmitSmarttagJob提交智能标签作业。

使用限制

  • 通过本接口提交智能标签作业时,需要先通过模板配置分析类型。具体操作请参见添加模板
  • 智能标签功能,目前开通的地域为华北2(北京)、华东2(上海)、华东1(杭州),其他地域暂不支持。
  • 目前智能标签管道默认并发数为2,如有更高需求,请提交工单联系阿里云客服进行评估配置。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String SubmitSmarttagJob

操作接口名,系统规定参数,取值:SubmitSmarttagJob

PipelineId String 2

管道ID,用于区分业务,绑定消息通知。可以通过MPS控制台 > 全局设置 > 管道获取。可以为空(空格),表示默认管道。默认管道并发为2,需要提升并发数请提交工单

说明 管道目前仅支持后台创建,相关查询、更新接口请参见更新管道
Title String example-title-****

视频标题,支持中英文、数字、中划线(-),不能以特殊符号开头,长度不能超过256B。

Content String example content ****

视频内容描述,支持中英文、数字、中划线(-),不能以特殊符号开头,长度不能超过1KB。

ContentType String application/zip

视频内容类型。

ContentAddr String ***

视频内容地址。可以使用外部链接或OSS链接。

Params String false

额外的请求参数,使用JSON字符串表示,例如:{"needAsrData":true, "needOcrData":false}。字段说明:

  • needAsrData:boolean值,分析结果中是否需要包含原始ASR结果,默认false(不包含),可选true(包含)
  • needOcrData:boolean值,分析结果中是否需要包含原始OCR结果,默认false(不包含),可选true(包含)
  • needMetaData:boolean值,分析结果中是否需要包含Meta信息,默认false(不包含),可选true(包含)
NotifyUrl String https://example.com/endpoint/aliyun/ai?id=76401125000***

Callback路径,目前仅支持MNS消息队列。消息队列的路径可以通过MNS控制台 > 队列列表 > 详情查看。

UserData String example UserData ****

通过MNS回调时透传回来的信息,长度不能超过1KB。如何设置MNS回调队列,请参见更新管道

Input String oss://mybucket-****/example-****.mp4

需要分析的视频或图片文件的地址,图片文件支持jpg、jpeg、png三种类型(按文件后缀名校验)。智能标签接口输入支持OSS地址、HTTP地址、视频点播(VoD)媒资地址等形式。

说明 请确认您的文件名正确且所在Bucket与接口调用地域一致,否则可能导致找不到文件或接口调用失败。
  • OSS地址:oss://[Bucket名称]/[文件路径],例如oss://[example-bucket-****]/[object_path-****]
  • HTTP地址:公网可下载的地址,例如http://example-test-****.mp4
  • 视频点播(VoD)媒资地址:vod://[VoD媒资MediaId],例如vod://MediaId

举例如下:

  • oss://mybucket-****/example-****.mp4
  • oss://testbucket-****/videos-****/1-****.mp4
  • http://example-label-****.oss-cn-beijing.aliyuncs.com/example-****.mp4
  • vod://181d739404a3419ba1c22b957ad2****
说明 注意OSS Bucket所在区域必须与调用OpenAPI所在的区域相同,MPS从用户Bucket拉取视频或图片免流量费用。
TemplateId String 39f8e0bc005e4f309379701645f4****

模板ID用于指定分析算法,模板相关操作参见添加模板查询模板更新模板删除模板

返回数据

名称 类型 示例值 描述
RequestId String 7B117AF5-2A16-412C-B127-FA6175ED1AD0

请求ID。

JobId String 39f8e0bc005e4f309379701645f4****

智能标签作业ID。建议您保存此ID便于后续调用其他接口时使用。

示例

请求示例

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=SubmitSmarttagJob
&PipelineId=2
&Title=example-title-****
&Content=example content ****
&ContentType=0
&ContentAddr=0
&Params=false
&NotifyUrl=0
&UserData=example UserData ****
&Input=oss://mybucket-****/example-****.mp4
&TemplateId=39f8e0bc005e4f309379701645f4****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SubmitSmarttagJobResponse>
    <RequestId>7B117AF5-2A16-412C-B127-FA6175ED1AD0</RequestId>
    <JobId>39f8e0bc005e4f309379701645f4****</JobId>
</SubmitSmarttagJobResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "7B117AF5-2A16-412C-B127-FA6175ED1AD0",
  "JobId" : "39f8e0bc005e4f309379701645f4****"
}

错误码

访问错误中心查看更多错误码。

SDK示例