查詢智能標簽任務。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
ice:QuerySmarttagJob | *全部資源 * |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
JobId | string | 是 | 需要查詢的智能標簽作業 ID。可以從提交智能標簽作業的返回參數中獲取。 | 88c6ca184c0e47098a5b665e2**** |
Params | string | 否 | 額外的請求參數,使用 JSON 字符串表示,例如:{"labelResultType":"auto"}。其中,labelResultType 為 String 類型,可取值:
| {"labelResultType":"auto"} |
返回參數
回調消息格式定義 當智能標簽任務執行狀態改變時,mps 會發送消息到用戶指定的 queue 中(如何指定回調 queue 詳見 mps 的更新管道接口)。消息體是一個 JSON 字符串,包含字段如下:
名稱 | 類型 | 描述 |
---|---|---|
Type | String | 固定字符串“smarttag”,表示智能標簽任務 |
JobId | String | 任務唯一 ID |
State | String | 任務當前狀態,與 QuerySmarttagJob 中的 JobStatus 一致 |
State | String | 任務當前狀態,與 QuerySmarttagJob 中的 JobStatus 一致 |
UserData | String | 用戶在 SubmitSmarttagJob 中傳入的 UserData |
UserData | String | 用戶在 SubmitSmarttagJob 中傳入的 UserData |
Result 參數說明
VideoLabel 數據結構
名稱 | 類型 | 描述 |
---|---|---|
persons | JSONArray | 檢測到的人物結果 |
persons.name | String | 識別到的人物名稱 |
persons.category | String | 人物類型,取值如下:celebrity (名人);politician (政治人物);sensitive (敏感人物);unknown (未知人物);自定義人物庫 ID(識別到的人物為自定義人物時返回) |
persons.ratio | double | 人物出現率,取值:0~1 |
persons.occurrences | JSONArray | 人物出場詳細信息 |
persons.occurrences.score | double | 置信度得分 |
persons.occurrences.from | double | 檢測到人物的起始時間,單位(秒) |
persons.occurrences.to | double | 檢測到人物的結束時間,單位(秒) |
persons.occurrences.position | JSONObject | 人臉坐標 |
persons.occurrences.position.leftTop | int[] | 左上角 x,y 坐標 |
persons.occurrences.position.rightBottom | int[] | 右下角 x,y 坐標 |
persons.occurrences.timestamp | double | 人臉坐標所在的時間戳,單位為秒 |
persons.occurrences.scene | String | 人物鏡頭,包括:closeUp (特寫);medium-closeUp (近景);medium (中景);medium-long (全景) |
tags | JSONArray | 檢測到的物體場景等標簽,詳見下表舉例 |
tags.mainTagName | String | 主標簽 |
tags.subTagName | String | 子標簽 |
tags.ratio | double | 出現率,取值:0~1 |
tags.occurrences | JSONArray | 出現詳細信息 |
tags.occurrences.score | double | 置信度得分 |
tags.occurrences.from | double | 起始時間,單位(秒) |
tags.occurrences.to | double | 結束時間,單位(秒) |
classifications | JSONArray | 視頻分類信息 |
classifications.score | double | 置信度得分 |
classifications.category1 | String | 一級分類,比如:生活、動漫、汽車等等 |
classifications.category2 | String | 二級分類,比如生活下面細分為:健康、家居等等 |
視頻 Tags 標簽舉例說明
mainTagName | subTagName |
---|---|
節目 | 比如:爸爸去哪兒、歡樂喜劇人等 |
人物角色 | 比如:醫生、護士、教師等 |
物體 | 比如:鋼琴、水杯、桌子、西紅柿炒雞蛋、小汽車、化妝品等 |
標識 | 比如:CCTV1、CCTV2、優酷、東方衛視等 |
動作事件 | 比如:跳舞、接吻、擁抱、會晤、唱歌、打電話、騎馬、打斗等 |
地域 | 比如:北京天安門、自由女神像、樂山大佛、中國、美國等 |
場景 | 比如:臥室、地鐵站、梯田、海灘、沙漠等 |
ImageLabel 數據結構
名稱 | 類型 | 描述 |
---|---|---|
persons | JSONArray | 檢測到的人物結果 |
persons.name | String | 識別到的人物名稱 |
persons.category | String | 人物類型,取值如下:celebrity(名人);politician(政治人物);sensitive(敏感人物) |
persons.score | double | 人物置信度得分 |
persons.position | JSONObject | 人臉坐標 |
persons.position.leftTop | int[] | 左上角 x,y 坐標 |
persons.position.rightBottom | int[] | 右下角 x,y 坐標 |
persons.scene | String | 人物鏡頭,包括:closeUp(特寫);medium-closeUp(近景);medium(中景);medium-long(全景) |
tags | JSONArray | 檢測到的物體場景等標簽,詳見下表舉例 |
tags.mainTagName | String | 主標簽 |
tags.subTagName | String | 子標簽 |
tags.score | double | 置信度得分 |
圖片 tags 標簽舉例說明
mainTagName | subTagName |
---|---|
人物角色 | 比如:醫生、護士、教師等 |
地域 | 比如:北京天安門、自由女神像、樂山大佛、中國、美國等 |
動作事件 | 比如:講話等 |
標識 | 比如:CCTV1、CCTV2、優酷、東方衛視等 |
動作事件 | 比如:跳舞、接吻、擁抱、會晤、唱歌、打電話、騎馬、打斗等 |
物體 | 比如:鋼琴、水杯、桌子、西紅柿炒雞蛋、小汽車、化妝品等 |
場景 | 比如:臥室、地鐵站、梯田、海灘、沙漠等 |
TextLabel 數據結構(來源于 ASR 和 OCR)
名稱 | 類型 | 描述 |
---|---|---|
tags | JSONArray | 文本標簽信息,詳見下表舉例 |
tags.name | String | 標簽類別 |
tags.value | String | 標簽值,可能有多個標簽值,以半角逗號(,)分割 |
圖片 tags 標簽舉例說明
name | value |
---|---|
地域 | 比如:北京天安門、自由女神像、樂山大佛、中國、美國等 |
組織機構 | 比如:中國生動物保護協會、中央廣播電視臺等 |
標識 | 比如:耐克、李寧 |
關鍵詞 | 比如:中堅力量 |
CPVLabel 數據結構
- cates:類目(一級類目、二級類目、三級類目)
- entities:類目屬性(帶有知識圖譜信息)
- hotwords:熱點詞(用戶關注的名單)
- freeTags:自由標簽(關鍵詞)
名稱 | 類型 | 示例值 | 說明 |
---|---|---|---|
type | String | hmi | 結果類型。取值:hmi(人機協同結果)、autp(機器打標結果) |
cates | JSONArray | - | 分類類目結果 |
cates.labelLevel1 | String | 旅游 | 一級標簽 |
cates.labelLevel2 | String | 旅游風光 | 二級標簽 |
cates.label | String | "" | 標簽名稱,算法可能返回空 |
cates.appearanceProbability | double | 0.96 | 出現率 |
cates.detailInfo | JSONArray | - | - |
cates.detailInfo.score | double | 0.9 | 置信度 |
cates.detailInfo.startTime | double | 0.021 | 開始時間 |
cates.detailInfo.endTime | double | 29.021 | 結束時間 |
entities | JSONArray | - | - |
entities.labelLevel1 | String | 地域 | 一級標簽 |
entities.labelLevel2 | String | 地標 | 二級標簽 |
entities.label | String | 黃果樹瀑布 | 標簽名稱 |
entities.appearanceProbability | double | 0.067 | 出現率 |
entities.knowledgeInfo | String | {"name": "黃果樹瀑布", "nameEn": "Huangguoshu Waterfall", "description": "亞洲四大瀑布之一"} | 知識圖譜信息,全部字段后附表:影視綜 IP 圖譜、音樂圖譜、人物圖譜、地標圖譜、物體圖譜。 |
entities.detailInfo | JSONArray | - | - |
entities.detailInfo.score | double | 0.33292606472969055 | 置信度 |
entities.detailInfo.startTime | double | 6.021 | 開始時間 |
entities.detailInfo.endTime | double | 8.021 | 結束時間 |
entities.detailInfo.trackData | JSONArray | - | 實體標簽結構化信息 |
entities.detailInfo.trackData.score | double | 0.32 | 置信度 |
entities.detailInfo.trackData.bbox | integer[] | 23,43,45,67 | 坐標框 |
entities.detailInfo.trackData.timestamp | double | 7.9 | 時間戳 |
hotwords | JSONArray | - | - |
hotwords.labelLevel1 | String | 關鍵詞 | 一級標簽 |
hotwords.labelLevel1 | String | 關鍵詞 | 二級標簽 |
hotwords.labelLevel2 | String | "" | 二級標簽 |
hotwords.label | String | 中國氣象局 | 看點詞內容 |
hotwords.appearanceProbability | double | 0.96 | 出現率 |
hotwords.detailInfo | JSONArray | ||
hotwords.detailInfo.score | double | 1.0 | 置信度 |
hotwords.detailInfo.startTime | double | 0.021 | 開始時間 |
hotwords.detailInfo.endTime | double | 29.021 | 結束時間 |
freeTags | JSONArray | ||
freeTags.labelLevel1 | String | 關鍵詞 | 一級標簽 |
freeTags.labelLevel2 | String | "" | 二級標簽 |
freeTags.label | String | 中央氣象臺 | 看點詞內容 |
freeTags.appearanceProbability | double | 0.96 | 出現率 |
freeTags.detailInfo | JSONArray | ||
freeTags.detailInfo.score | double | 0.9 | 置信度 |
freeTags.detailInfo.startTime | double | 0.021 | 開始時間 |
freeTags.detailInfo.endTime | double | 29.021 | 結束時間 |
語音識別 ASR 結果
名稱 | 類型 | 描述 |
---|---|---|
details | JSONArray | 任務詳細結果 |
details.from | double | 開始時間戳,單位(秒) |
details.to | double | 結束時間戳,單位(秒) |
details.content | String | 識別出的文本內容 |
文本識別 OCR 結果
名稱 | 類型 | 描述 |
---|---|---|
details | JSONArray | 任務詳細結果 |
details.timestamp | double | 時間戳信息,單位(秒) |
details.info | JSONArray | 該時間點識別出的具體信息 |
details.info.score | double | 置信度得分 |
details.info.position | JSONObject | 文字坐標 |
details.info.position.leftTop | int[] | 左上角 x,y 坐標 |
details.info.position.rightBottom | int[] | 右下角 x,y 坐標 |
details.info.content | String | 識別出的文本內容 |
Meta 標注結果
名稱 | 類型 | 描述 |
---|---|---|
title | String | 標題 |
字幕提取結果 Subtitle
名稱 | 類型 | 描述 |
---|---|---|
details | JSONArray | 任務詳細結果 |
details.allResultUrl | String | 全部字幕結果 URL,URL 有效期為任務完成后半年內可有效訪問 |
details.chResultUrl | String | 中文結果 URL,URL 有效期為任務完成后半年內可有效訪問 |
details.engResultUrl | String | 英文結果 URL,URL 有效期為任務完成后半年內可有效訪問 |
序號+時間段+字幕內容(每句字幕為一行)
。
NLP 處理結果
參數名 | 類型 | 說明 |
---|---|---|
transcription | object | 語音轉寫結果 |
autoChapters | object | 章節速覽結果 |
summarization | object | 大模型摘要結果 |
meetingAssistance | object | 智能紀要結果 |
translation | object | 文本翻譯結果 |
transcription(語音轉錄)
參數名 | 類型 | 說明 |
---|---|---|
transcription | object | 語音轉寫結果對象。 |
transcription.paragraphs | list[] | 語音轉寫結構以段落形式組織的集合。 |
transcription.paragraphs[i].paragraphId | string | 段落級別 id。 |
transcription.paragraphs[i].speakerId | string | 發言人 id。 |
transcription.paragraphs[i].words | list[] | 該段落包含的 word 信息。 |
transcription.paragraphs[i].words[i].id | int | word 序號,通常無須關注。 |
transcription.paragraphs[i].words[i].sentenceId | int | 句子 id,同屬于一個 SentenceId 的 word 信息可以組裝成一句話。 |
transcription.paragraphs[i].words[i].start | long | 該 word 相對于音頻起始時間的開始時間,相對時間戳,單位毫秒。 |
transcription.paragraphs[i].words[i].end | long | 該 word 相對于音頻起始時間的結束時間,相對時間戳,單位毫秒。 |
transcription.paragraphs[i].words[i].text | string | word 文本。 |
summarization(全文摘要、發言人總結、提問摘要)
參數名 | 類型 | 說明 |
---|---|---|
summarization | object | 摘要結果對象,可能包含 0 個或多個不同摘要類型的結果。 |
summarization.paragraphSummary | string | 全文摘要結果。 |
summarization.conversationalSummary | list[] | 發言總結摘要結果列表。 |
summarization.conversationalSummary[i].speakerId | string | 發言人 id。 |
summarization.conversationalSummary[i].speakerName | string | 發言人名字。 |
summarization.conversationalSummary[i].summary | string | 該發言人對應的總結。 |
summarization.questionsAnsweringSummary | list[] | 問答摘要結果列表。 |
summarization.questionsAnsweringSummary[i].question | string | 問題 |
summarization.questionsAnsweringSummary[i].sentenceIdsOfQuestion | list[] | 提煉出該問題對應的原語音轉寫的 SentenceId 列表。 |
summarization.questionsAnsweringSummary[i].answer | string | 問題對應的答案。 |
summarization.questionsAnsweringSummary[i].sentenceIdsOfAnswer | list[] | 總結出該答案對應的原語音轉寫的 SentenceId 列表。 |
summarization.mindMapSummary | list[object] | 思維導圖摘要結果列表,可能包含各個主題的摘要、主題間的關系等。 |
summarization.mindMapSummary[i].title | string | 主題的標題。 |
summarization.mindMapSummary[i].topic | list[object] | 包含每個主題及其子主題的數組 |
summarization.mindMapSummary[i].topic[i].title | string | 主題的標題。 |
summarization.mindMapSummary[i].topic[i].topic | list[object] | 主題的子主題數組,可以是空數組。 |
translation(全文翻譯)
參數名 | 類型 | 說明 |
---|---|---|
translation | object | 翻譯結果對象。 |
translation.paragraphs | list[] | 翻譯結果以段落形式組織的集合,和語音識別結果報文對應。 |
translation.paragraphs.paragraphId | string | 段落分段 id 標識,和語音識別結果中的 ParagraphId 對應。 |
translation.paragraphs.sentences | list[] | 翻譯文本集合。 |
translation.paragraphs.sentences[i].sentenctId | long | 句子 id。 |
translation.paragraphs.sentences[i].start | long | 該段相對于音頻起始時間的開始時間,相對時間戳,單位毫秒。 |
translation.paragraphs.sentences[i].end | long | 該段相對于音頻起始時間的結束時間,相對時間戳,單位毫秒。 |
translation.paragraphs.sentences[i].text | string | 翻譯文本,和語音識別結果報文對應。 |
autoChapters(章節識別)
參數名 | 類型 | 說明 |
---|---|---|
autoChapters | list[] | 章節速覽集合, 含有 0 個、1 個或多個章節速覽信息。 |
autoChapters[i].id | int | 該章節序號。 |
autoChapters[i].start | long | 該章節相對于音頻起始時間的開始時間,相對時間戳,單位毫秒。 |
autoChapters[i].end | long | 該章節相對于音頻起始時間的結束時間,相對時間戳,單位毫秒。 |
autoChapters[i].headline | string | 該章節的一句話標題。 |
autoChapters[i].summary | string | 章節總結。 |
meetingAssistance(智能紀要提取,包含關鍵詞、關鍵句、待辦事項提?。?/strong>
參數名 | 類型 | 說明 |
---|---|---|
meetingAssistance | object | 智能紀要結果對象,可能包含 0 個或多個不同類型的結果。 |
meetingAssistance.keywords | list[] | 關鍵詞提取結果。 |
meetingAssistance.keySentences | list[] | 關鍵句提取結果,也稱為重點內容。 |
meetingAssistance.keySentences[i].id | long | 關鍵句序號。 |
meetingAssistance.keySentences[i].sentenceId | long | 該關鍵句在原 ASR 轉寫中對應的句子 Id。 |
meetingAssistance.keySentences[i].start | long | 相對于音頻起始時間的開始時間,相對時間戳,單位毫秒。 |
meetingAssistance.keySentences[i].end | long | 相對于音頻起始時間的結束時間,相對時間戳,單位毫秒。 |
meetingAssistance.keySentences[i].text | string | 關鍵句信息。 |
meetingAssistance.actions | list[] | 待辦內容、待辦摘要的集合。 |
meetingAssistance.actions[i].id | long | 待辦序號。 |
meetingAssistance.actions[i].sentenceId | long | 該關鍵句在原 ASR 轉寫中對應的句子 Id。 |
meetingAssistance.actions[i].start | long | 相對于音頻起始時間的開始時間,相對時間戳,單位毫秒。 |
meetingAssistance.actions[i].end | long | 相對于音頻起始時間的結束時間,相對時間戳,單位毫秒。 |
meetingAssistance.actions[i].text | string | 待辦內容。 |
meetingAssistance.classifications | object | 場景分類,目前只有 3 中場景分類。 |
meetingAssistance.classifications.interview | float | 面試場景置信度得分。 |
meetingAssistance.classifications.lecture | float | 演講場景置信度得分。 |
meetingAssistance.classifications.meeting | float | 會議場景置信度得分。 |
示例
正常返回示例
JSON
格式
{
"JobStatus": "Success",
"RequestId": "******11-DB8D-4A9A-875B-275798******",
"UserData": "{\"userId\":\"123432412831\"}",
"Results": {
"Result": [
{
"Type": "Meta",
"Data": "{\"title\":\"example-title-****\"}\t\n"
}
]
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2022-08-25 | 新增 OpenAPI | 查看變更詳情 |