SubmitSmarttagJob_媒体处理_API文档

2014-06-18

获取元数据获取 SDK

找不到 API ? 点击反馈吧

插件下载了解更多

VS Code 插件反馈

安装插件之前，确保已安装 VS Code

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.

JetBrains 插件反馈

安装插件之前，确保已安装 JetBrains IDE

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

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

QPS 限制

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

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

mts:SubmitSmarttagJob		全部资源 *	无	无

请求参数

字段名称	字段详情
PipelineIdstring	管道 ID，用于区分业务，绑定消息通知。可以通过 MPS 控制台 > 全局设置 > 管道获取。可以为空（空格），表示默认管道。默认管道并发为 10，需要提升并发数请提交工单。展开详情示例值:2
Titlestring	视频标题，支持中英文、数字、中划线（-），不能以特殊符号开头，长度不能超过 256B。示例值:example-title-****
Contentstring	视频内容描述，支持中英文、数字、中划线（-），不能以特殊符号开头，长度不能超过 1KB。示例值:example content ****
ContentTypestring	已废弃示例值:application/zip
ContentAddrstring	已废弃示例值:http://exampleBucket.oss-cn-shanghai.aliyuncs.com/mps-test/ai-tag.mp4
Paramsstring	额外的请求参数，使用 JSON 字符串表示，例如：`{"needAsrData":true, "needOcrData":false}`。字段说明：展开详情示例值:{"needAsrData":true, "needOcrData":false, "nlpParams":{"sourceLanguage":"cn"}}
NotifyUrlstring	Callback 路径，目前仅支持 HTTP、HTTPS 地址。示例值:https://example.com/endpoint/aliyun/ai?id=76401125000***
UserDatastring	通过回调透传回来的信息，长度不能超过 1KB。示例值:{"key":"value"}
Inputstring	需要分析的视频或图片文件的地址，图片文件支持 jpg、jpeg、png 三种类型（按文件后缀名校验）。智能标签接口输入支持 OSS 地址、HTTP 地址、视频点播（VoD）媒资地址等形式。展开详情示例值:oss://mybucket-**/example-**.mp4
TemplateIdstring	模板 ID 用于指定分析算法，模板相关操作参见添加模板，查询模板，更新模板，删除模板。展开详情示例值:39f8e0bc005e4f309379701645f4****参考取值来源: AddSmarttagTemplate QuerySmarttagTemplateList
Prioritystring	任务在其对应管道内的优先级。最高优先级：0，最低优先级：9。默认值：5。示例值:5

请求说明

nlpParams 说明

功能	名称	类型	必填	描述	示例值
	nlpParams	object	是	该参数包含了所有 nlp 处理的相关参数，template 分析类型包含 nlp 的时候必填，否则任务失败。	{"sourceLanguage":"cn"}
转录	sourceLanguage	string	是	转写使用的源语言模型，可选：cn（中文）、en（英文）、 yue（粤语）、 fspk（中英文自由说）。	"cn"
	diarizationEnabled	boolean	否	是否开启说话人分离功能，默认 false。	true
	speakerCount	integer	否	设置说话人分离参数。不设置：不使用说话人角色区分。0：说话人角色区分结果为不定人数。2：说话人角色区分结果为 2 人。	2
摘要	summarizationEnabled	boolean	否	是否启用摘要功能，开启后会可以生成全文摘要、发言人总结等结果。	true
	summarizationTypes	string	否	开启摘要功能时，需传入期望的摘要类型：Paragraph（全文摘要）、Conversational（发言人总结）、QuestionsAnswering（问答摘要）。	"Paragraph,Conversational,QuestionsAnswering"
翻译	translationEnabled	boolean	否	是否启用翻译功能。	true
	targetLanguages	string	否	开启翻译功能后的目标语言，可选：cn（中文）、en（英文）、 ja（日文）。	"en"
章节识别	autoChaptersEnabled	boolean	否	是否启用章节速览功能，结果包含章节标题、章节摘要。	true
智能纪要	meetingAssistanceEnabled	boolean	否	是否开启会议协助功能，结果包含分类、关键词、关键句、待办事项。若启用 MeetingAssistanceEnabled 但未通过 MeetingAssistance 设置算法类型，则默认都进行调用和返回。	true
	meetingAssistanceTypes	string	否	开启智能功能时，需传入期望的功能参数类型，支持待办(Actions)、关键信息(KeyInformation)。其中关键信息包含关键词和重点内容(关键句)。	"Actions,KeyInformation"

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:7B117AF5-2A16-412C-B127-FA6175ED1AD0
JobIdstring	智能标签作业 ID。建议您保存此 ID 便于后续调用其他接口时使用。示例值:39f8e0bc005e4f309379701645f4****

返回示例

变更历史

	变更时间	变更内容概要	操作
	2023-07-05	新增请求参数Priority

相关示例

智能标签任务接口

智能标签任务相关接口，调用SubmitSmarttagJob提交智能标签作业，调用QuerySmarttagJob查询智能标签作业。

2022-02-22