提交智能標(biāo)簽作業(yè)。
接口說(shuō)明
- 通過(guò)本接口提交智能標(biāo)簽作業(yè)時(shí)，需要先通過(guò)模板配置分析類(lèi)型。具體操作請(qǐng)參見(jiàn)添加模板。
- 智能標(biāo)簽功能，目前開(kāi)通的地域?yàn)槿A北 2（北京）、華東 2（上海）、華東 1（杭州），其他地域暫不支持。
- 目前智能標(biāo)簽管道默認(rèn)并發(fā)數(shù)為 2，如有更高需求，請(qǐng)提交工單聯(lián)系阿里云客服進(jìn)行評(píng)估配置。
QPS 限制
本接口的單用戶(hù) QPS 限制為 100 次/秒。超過(guò)限制，API 調(diào)用會(huì)被限流，這可能會(huì)影響您的業(yè)務(wù)，請(qǐng)合理調(diào)用。更多信息，請(qǐng)參見(jiàn) QPS 限制。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語(yǔ)句的Action元素中使用，用來(lái)給RAM用戶(hù)或RAM角色授予調(diào)用此API的權(quán)限。具體說(shuō)明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問(wèn)級(jí)別：是指每個(gè)操作的訪問(wèn)級(jí)別，取值為寫(xiě)入（Write）、讀取（Read）或列出（List）。
- 資源類(lèi)型：是指操作中支持授權(quán)的資源類(lèi)型。具體說(shuō)明如下：
- 對(duì)于必選的資源類(lèi)型，用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問(wèn)級(jí)別 | 資源類(lèi)型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| mts:SubmitSmarttagJob |
|
| 無(wú) |
請(qǐng)求參數(shù)
| 名稱(chēng) | 類(lèi)型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| PipelineId | string | 是 | 管道 ID，用于區(qū)分業(yè)務(wù)，綁定消息通知。可以通過(guò) MPS 控制臺(tái) > 全局設(shè)置 > 管道獲取。可以為空（空格），表示默認(rèn)管道。默認(rèn)管道并發(fā)為 2，需要提升并發(fā)數(shù)請(qǐng)?zhí)峤?a id="" class="" target="_blank">工單。 說(shuō)明
管道目前僅支持后臺(tái)創(chuàng)建，相關(guān)查詢(xún)、更新接口請(qǐng)參見(jiàn)更新管道。
| 2 |
| Title | string | 是 | 視頻標(biāo)題，支持中英文、數(shù)字、中劃線(xiàn)（-），不能以特殊符號(hào)開(kāi)頭，長(zhǎng)度不能超過(guò) 256B。 | example-title-**** |
| Content | string | 否 | 視頻內(nèi)容描述，支持中英文、數(shù)字、中劃線(xiàn)（-），不能以特殊符號(hào)開(kāi)頭，長(zhǎng)度不能超過(guò) 1KB。 | example content **** |
| ContentType | string | 否 | 已廢棄 | application/zip |
| ContentAddr | string | 否 | 已廢棄 | http://exampleBucket.oss-cn-shanghai.aliyuncs.com/mps-test/ai-tag.mp4 |
| Params | string | 否 | 額外的請(qǐng)求參數(shù)，使用 JSON 字符串表示，例如：
| {"needAsrData":true, "needOcrData":false, "nlpParams":{"sourceLanguage":"cn"}} |
| NotifyUrl | string | 否 | Callback 路徑，目前僅支持 HTTP、HTTPS 地址。 | https://example.com/endpoint/aliyun/ai?id=76401125000*** |
| UserData | string | 否 | 通過(guò)回調(diào)透?jìng)骰貋?lái)的信息，長(zhǎng)度不能超過(guò) 1KB。 | {"key":"value"} |
| Input | string | 是 | 需要分析的視頻或圖片文件的地址，圖片文件支持 jpg、jpeg、png 三種類(lèi)型（按文件后綴名校驗(yàn)）。智能標(biāo)簽接口輸入支持 OSS 地址、HTTP 地址、視頻點(diǎn)播（VoD）媒資地址等形式。 說(shuō)明
請(qǐng)確認(rèn)您的文件名正確且所在 Bucket 與接口調(diào)用地域一致，否則可能導(dǎo)致找不到文件或接口調(diào)用失敗。
舉例如下：
說(shuō)明
注意 OSS Bucket 所在區(qū)域必須與調(diào)用 OpenAPI 所在的區(qū)域相同，MPS 從用戶(hù) Bucket 拉取視頻或圖片免流量費(fèi)用。
| oss://mybucket-****/example-****.mp4 |
| TemplateId | string | 否 | 39f8e0bc005e4f309379701645f4**** | |
| Priority | string | 否 | 任務(wù)在其對(duì)應(yīng)管道內(nèi)的優(yōu)先級(jí)。最高優(yōu)先級(jí)：0，最低優(yōu)先級(jí)：9。默認(rèn)值：5。 | 5 |
nlpParams 說(shuō)明
| 功能 | 名稱(chēng) | 類(lèi)型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|---|
| nlpParams | object | 是 | 該參數(shù)包含了所有 nlp 處理的相關(guān)參數(shù)，template 分析類(lèi)型包含 nlp 的時(shí)候必填，否則任務(wù)失敗。 | {"sourceLanguage":"cn"} | |
| 轉(zhuǎn)錄 | sourceLanguage | string | 是 | 轉(zhuǎn)寫(xiě)使用的源語(yǔ)言模型，可選：cn（中文）、en（英文）、 yue（粵語(yǔ)）、 fspk（中英文自由說(shuō)）。 | "cn" |
| diarizationEnabled | boolean | 否 | 是否開(kāi)啟說(shuō)話(huà)人分離功能，默認(rèn) false。 | true | |
| speakerCount | integer | 否 | 設(shè)置說(shuō)話(huà)人分離參數(shù)。 不設(shè)置：不使用說(shuō)話(huà)人角色區(qū)分。0：說(shuō)話(huà)人角色區(qū)分結(jié)果為不定人數(shù)。2：說(shuō)話(huà)人角色區(qū)分結(jié)果為 2 人。 | 2 | |
| 摘要 | summarizationEnabled | boolean | 否 | 是否啟用摘要功能，開(kāi)啟后會(huì)可以生成全文摘要、發(fā)言人總結(jié)等結(jié)果。 | true |
| summarizationTypes | string | 否 | 開(kāi)啟摘要功能時(shí)，需傳入期望的摘要類(lèi)型：Paragraph（全文摘要）、Conversational（發(fā)言人總結(jié)）、QuestionsAnswering（問(wèn)答摘要）。 | "Paragraph,Conversational,QuestionsAnswering" | |
| 翻譯 | translationEnabled | boolean | 否 | 是否啟用翻譯功能。 | true |
| targetLanguages | string | 否 | 開(kāi)啟翻譯功能后的目標(biāo)語(yǔ)言，可選：cn（中文）、en（英文）、 yue（粵語(yǔ)）、 fspk（中英文自由說(shuō)）。 | "en,cn" | |
| 章節(jié)識(shí)別 | autoChaptersEnabled | boolean | 否 | 是否啟用章節(jié)速覽功能，結(jié)果包含章節(jié)標(biāo)題、章節(jié)摘要。 | true |
| 智能紀(jì)要 | meetingAssistanceEnabled | boolean | 否 | 是否開(kāi)啟會(huì)議協(xié)助功能，結(jié)果包含分類(lèi)、關(guān)鍵詞、關(guān)鍵句、待辦事項(xiàng)。 | true |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "7B117AF5-2A16-412C-B127-FA6175ED1AD0",
"JobId": "39f8e0bc005e4f309379701645f4****"
}錯(cuò)誤碼
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2023-07-05 | OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |