调用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 否 http://exampleBucket.oss-cn-shanghai.aliyuncs.com/mps-test/ai-tag.mp4

视频内容地址。可以使用外部链接或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路径，目前仅支持HTTP、HTTPS地址。
UserData String 否 {"key":"value"}

通过回调透传回来的信息，长度不能超过1KB。
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=application/zip
&ContentAddr=http://exampleBucket.oss-cn-shanghai.aliyuncs.com/mps-test/ai-tag.mp4
&Params=false
&NotifyUrl=https://example.com/endpoint/aliyun/ai?id=76401125000***
&UserData={"key":"value"}
&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示例