调用SubmitSmarttagJob提交智能标签作业_智能媒体服务(IMS)-阿里云帮助中心

提交智能标签作业。

接口说明

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

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
Title	string	是	视频标题，支持中英文、数字、中划线（-），不能以特殊符号开头，长度不能超过 256B。	example-title-****
Content	string	否	视频内容描述，支持中英文、数字、中划线（-），不能以特殊符号开头，长度不能超过 1KB。	example content ****
ContentType	string	否	已废弃
ContentAddr	string	否	已废弃
Params	string	否	额外的请求参数，使用 JSON 字符串表示，例如：{"needAsrData":true, "needOcrData":false}。字段说明： needAsrData：boolean 值，分析结果中是否需要包含原始 ASR 结果，默认 false（不包含），可选 true（包含） needOcrData：boolean 值，分析结果中是否需要包含原始 OCR 结果，默认 false（不包含），可选 true（包含） needMetaData：boolean 值，分析结果中是否需要包含 Meta 信息，默认 false（不包含），可选 true（包含） nlpParams: JsonObject 值，nlp 算子的输入参数，默认为空（不使用 nlp 算子），详见请求参数补充说明。	{"needAsrData":true, "needOcrData":false, "nlpParams":{"sourceLanguage":"cn"}}
NotifyUrl	string	否	Callback 路径，目前仅支持 http/https。	https://example.com/endpoint/aliyun/ai?id=76401125000***
UserData	string	否	通过 MNS 回调时透传回来的信息，长度不能超过 1KB。如何设置 MNS 回调队列，请参见更新管道。	{“a”:"test"}
Input	object	是	input
Type	string	否	媒体类型，一下两种类型二选一： OSS Media URL	Media
Media	string	否	上面的 Type 为 OSS 的话，写 OSS 地址，例如：OSS://test-bucket/video/202208/test.mp4 Type 为 Media 的话写 mediaId：c5c62d8f0361337cab312dce8e77dc6d Type 为 URL 的话写 http url，例如：https://zc-test.oss-cn-shanghai.aliyuncs.com/test/unknowFace.mp4	c5c62d8f0361337cab312dce8e77dc6d
TemplateId	string	否	模板 ID 用于指定分析算法，模板相关操作参见统一模版配置。也可使用公共模版： nlp 分析：public-nlp	39f8e0bc005e4f309379701645f4
ScheduleConfig	object	否	scheduleConfig
PipelineId	string	否	道 ID，用于区分业务，绑定消息通知。表示默认管道。默认管道并发为 2，需要提升并发数请提交工单。	acdbfe4323bcfdae
Priority	string	否	优先级，暂时未实现，可以不填或随便填。	4

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（英文）、 yue（粤语）、 fspk（中英文自由说）。	"en,cn"
章节识别	autoChaptersEnabled	boolean	否	是否启用章节速览功能，结果包含章节标题、章节摘要。	true
智能纪要	meetingAssistanceEnabled	boolean	否	是否开启会议协助功能，结果包含分类、关键词、关键句、待办事项。	true

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	****11-DB8D-4A9A-875B-275798****
JobId	string	智能标签作业 ID。建议您保存此 ID 便于后续调用其他接口时使用。	**d80e4e4044975745c14b**

示例

正常返回示例

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "JobId": "****d80e4e4044975745c14b****"
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2022-08-25	新增 OpenAPI	看变更集

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