全部產品
Search
文件中心

Intelligent Media Services:QuerySmarttagJob - 智能標籤任務查詢介面

更新時間:Jun 06, 2026

查詢智能標籤任務。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:QuerySmarttagJob

get

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

JobId

string

需要查詢的智能標籤作業 ID。可以從提交智能標籤作業的返回參數中擷取。

88c6ca184c0e47098a5b665e2****

Params

string

額外的請求參數,使用 JSON 字串表示,例如:{"labelResultType":"auto"}。其中,labelResultType 為 String 類型,可取值:

  • auto:機器打標結果

  • hmi:人機協同結果

{"labelResultType":"auto"}

返回參數

名稱

類型

描述

樣本值

object

JobStatus

string

任務狀態,可取值:

  • Success:處理成功。

  • Fail:處理失敗。

  • Processing:處理中。

  • Submitted:已提交等待處理。

Success

RequestId

string

請求 ID。

******11-DB8D-4A9A-875B-275798******

UserData

string

通過 MNS 回調時透傳回來的資訊。訊息格式請參見下文回調訊息格式定義。

{"userId":"123432412831"}

Results

object

Result

array<object>

分析結果對象數組。

object

Type

string

分析結果的類型。

  • - 標籤 1.0 分析結果類型:

  1. TextLabel:文字標籤

  2. VideoLabel:視頻標籤

  3. ASR:語音辨識原始結果(預設不返回)

  4. OCR:文字識別原始結果(預設不返回)

  5. NLP:NLP 處理結果(預設不返回)

  • - 標籤 2.0 分析結果類型:

  1. CPVLabel

  2. Meta:視頻標題等資訊(預設不返回)

  • - 標籤 2.0-custom 分析結果類型:

  1. CPVLabel

  2. Meta:視頻標題等資訊(預設不返回)

Meta

Data

string

分析結果的具體資料,以 JSON 字串表示。不同 Type 的資料結構見下文 Result 參數說明。

{"title":"example-title-****"}

Usages

object

Usage

array<object>

object

Type

string

Quota

integer

回調訊息格式定義 當智能標籤任務執行狀態改變時,mps 會發送訊息到使用者指定的 queue 中(如何指定回調 queue 詳見 mps 的更新管道介面)。訊息體是一個 JSON 字串,包含欄位如下:

名稱類型描述
TypeString固定字串“smarttag”,表示智能標籤任務
JobIdString任務唯一 ID
StateString任務目前狀態,與 QuerySmarttagJob 中的 JobStatus 一致
StateString任務目前狀態,與 QuerySmarttagJob 中的 JobStatus 一致
UserDataString使用者在 SubmitSmarttagJob 中傳入的 UserData
UserDataString使用者在 SubmitSmarttagJob 中傳入的 UserData

Result 參數說明

VideoLabel 資料結構

名稱類型描述
personsJSONArray檢測到的人物結果
persons.nameString識別到的人物名稱
persons.categoryString人物類型,取值如下:celebrity(名人);politician(政治人物);sensitive(敏感人物);unknown(未知人物);自訂人物庫 ID(識別到的人物為自訂人物時返回)
persons.ratiodouble人物出現率,取值:0~1
persons.occurrencesJSONArray人物出場詳細資料
persons.occurrences.scoredouble信賴度得分
persons.occurrences.fromdouble檢測到人物的起始時間,單位(秒)
persons.occurrences.todouble檢測到人物的結束時間,單位(秒)
persons.occurrences.positionJSONObject人臉座標
persons.occurrences.position.leftTopint[]左上方 x,y 座標
persons.occurrences.position.rightBottomint[]右下角 x,y 座標
persons.occurrences.timestampdouble人臉座標所在的時間戳記,單位為秒
persons.occurrences.sceneString人物鏡頭,包括:closeUp(特寫);medium-closeUp(近景);medium(中景);medium-long(全景)
tagsJSONArray檢測到的物體情境等標籤,詳見下表舉例
tags.mainTagNameString主標籤
tags.subTagNameString子標籤
tags.ratiodouble出現率,取值:0~1
tags.occurrencesJSONArray出現詳細資料
tags.occurrences.scoredouble信賴度得分
tags.occurrences.fromdouble起始時間,單位(秒)
tags.occurrences.todouble結束時間,單位(秒)
classificationsJSONArray視頻分類資訊
classifications.scoredouble信賴度得分
classifications.category1String一級分類,比如:生活、動漫、汽車等等
classifications.category2String二級分類,比如生活下面細分為:健康、家居等等

視頻 Tags 標籤舉例說明

mainTagNamesubTagName
節目比如:爸爸去哪兒、歡樂喜劇人等
人物角色比如:醫生、護士、教師等
物體比如:鋼琴、水杯、桌子、西紅柿炒雞蛋、小汽車、化妝品等
標識比如:CCTV1、CCTV2、優酷、東方衛視等
動作事件比如:跳舞、接吻、擁抱、會晤、唱歌、打電話、騎馬、打鬥等
地區比如:北京天安門、自由女神像、樂山大佛、中國、美國等
情境比如:臥室、地鐵站、梯田、海灘、沙漠等

ImageLabel 資料結構

名稱類型描述
personsJSONArray檢測到的人物結果
persons.nameString識別到的人物名稱
persons.categoryString人物類型,取值如下:celebrity(名人);politician(政治人物);sensitive(敏感人物)
persons.scoredouble人物信賴度得分
persons.positionJSONObject人臉座標
persons.position.leftTopint[]左上方 x,y 座標
persons.position.rightBottomint[]右下角 x,y 座標
persons.sceneString人物鏡頭,包括:closeUp(特寫);medium-closeUp(近景);medium(中景);medium-long(全景)
tagsJSONArray檢測到的物體情境等標籤,詳見下表舉例
tags.mainTagNameString主標籤
tags.subTagNameString子標籤
tags.scoredouble信賴度得分

圖片 tags 標籤舉例說明

mainTagNamesubTagName
人物角色比如:醫生、護士、教師等
地區比如:北京天安門、自由女神像、樂山大佛、中國、美國等
動作事件比如:講話等
標識比如:CCTV1、CCTV2、優酷、東方衛視等
動作事件比如:跳舞、接吻、擁抱、會晤、唱歌、打電話、騎馬、打鬥等
物體比如:鋼琴、水杯、桌子、西紅柿炒雞蛋、小汽車、化妝品等
情境比如:臥室、地鐵站、梯田、海灘、沙漠等

TextLabel 資料結構(來源於 ASR 和 OCR)

名稱類型描述
tagsJSONArray文字標籤資訊,詳見下表舉例
tags.nameString標籤類別
tags.valueString標籤值,可能有多個標籤值,以半形逗號(,)分割

圖片 tags 標籤舉例說明

namevalue
地區比如:北京天安門、自由女神像、樂山大佛、中國、美國等
組織機構比如:中國生動物保護協會、中央廣播電視台等
標識比如:耐克、李寧
關鍵詞比如:中堅力量

CPVLabel 資料結構

  • cates:類目(一級類目、二級類目、三級類目)

  • entities:類目屬性(帶有知識圖譜資訊)

  • hotwords:熱點詞(使用者關注的名單)

  • freeTags:自由標籤(關鍵詞)

名稱類型樣本值說明
typeStringhmi結果類型。取值:hmi(人機協同結果)、autp(機器打標結果)
catesJSONArray-分類類目結果
cates.labelLevel1String旅遊一級標籤
cates.labelLevel2String旅遊風光二級標籤
cates.labelString""標籤名稱,演算法可能返回空
cates.appearanceProbabilitydouble0.96出現率
cates.detailInfoJSONArray--
cates.detailInfo.scoredouble0.9信賴度
cates.detailInfo.startTimedouble0.021開始時間
cates.detailInfo.endTimedouble29.021結束時間
entitiesJSONArray--
entities.labelLevel1String地區一級標籤
entities.labelLevel2String地標二級標籤
entities.labelString黃果樹瀑布標籤名稱
entities.appearanceProbabilitydouble0.067出現率
entities.knowledgeInfoString{"name": "黃果樹瀑布", "nameEn": "Huangguoshu Waterfall", "description": "亞洲四大瀑布之一"}知識圖譜資訊,全部欄位後附表:影視綜 IP 圖譜、音樂圖譜、人物圖譜、地標圖譜、物體圖譜。
entities.detailInfoJSONArray--
entities.detailInfo.scoredouble0.33292606472969055信賴度
entities.detailInfo.startTimedouble6.021開始時間
entities.detailInfo.endTimedouble8.021結束時間
entities.detailInfo.trackDataJSONArray-實體標籤結構化資訊
entities.detailInfo.trackData.scoredouble0.32信賴度
entities.detailInfo.trackData.bboxinteger[]23,43,45,67座標框
entities.detailInfo.trackData.timestampdouble7.9時間戳記
hotwordsJSONArray--
hotwords.labelLevel1String關鍵詞一級標籤
hotwords.labelLevel1String關鍵詞二級標籤
hotwords.labelLevel2String""二級標籤
hotwords.labelString中國氣象局看點詞內容
hotwords.appearanceProbabilitydouble0.96出現率
hotwords.detailInfoJSONArray
hotwords.detailInfo.scoredouble1.0信賴度
hotwords.detailInfo.startTimedouble0.021開始時間
hotwords.detailInfo.endTimedouble29.021結束時間
freeTagsJSONArray
freeTags.labelLevel1String關鍵詞一級標籤
freeTags.labelLevel2String""二級標籤
freeTags.labelString中央氣象台看點詞內容
freeTags.appearanceProbabilitydouble0.96出現率
freeTags.detailInfoJSONArray
freeTags.detailInfo.scoredouble0.9信賴度
freeTags.detailInfo.startTimedouble0.021開始時間
freeTags.detailInfo.endTimedouble29.021結束時間

語音辨識 ASR 結果

名稱類型描述
detailsJSONArray任務詳細結果
details.fromdouble開始時間戳,單位(秒)
details.todouble結束時間戳記,單位(秒)
details.contentString識別出的常值內容

文本識別 OCR 結果

名稱類型描述
detailsJSONArray任務詳細結果
details.timestampdouble時間戳記資訊,單位(秒)
details.infoJSONArray該時間點識別出的具體資訊
details.info.scoredouble信賴度得分
details.info.positionJSONObject文字座標
details.info.position.leftTopint[]左上方 x,y 座標
details.info.position.rightBottomint[]右下角 x,y 座標
details.info.contentString識別出的常值內容

Meta 標註結果

說明

如果客戶沒有使用人機標註,在使用 SubmitSmarttagJob 提交任務時如果指定了 needMetaData,目前 QuerySmarttagJob 返回結果時會返回原始客戶輸入的標題。

名稱類型描述
titleString標題

字幕提取結果 Subtitle

名稱類型描述
detailsJSONArray任務詳細結果
details.allResultUrlString全部字幕結果 URL,URL 有效期間為任務完成後半年內可有效訪問
details.chResultUrlString中文結果 URL,URL 有效期間為任務完成後半年內可有效訪問
details.engResultUrlString英文結果 URL,URL 有效期間為任務完成後半年內可有效訪問
說明

字幕結果 URL 內容:序號+時間段+字幕內容(每句字幕為一行)

NLP 處理結果

參數名類型說明
transcriptionobject語音轉寫結果
autoChaptersobject章節預覽結果
summarizationobject大模型摘要結果
meetingAssistanceobject智能紀要結果
translationobject文本翻譯結果

transcription(語音轉錄)

參數名類型說明
transcriptionobject語音轉寫結果對象。
transcription.paragraphslist[]語音轉寫結構以段落形式組織的集合。
transcription.paragraphs[i].paragraphIdstring段落層級 id。
transcription.paragraphs[i].speakerIdstring發言人 id。
transcription.paragraphs[i].wordslist[]該段落包含的 word 資訊。
transcription.paragraphs[i].words[i].idintword 序號,通常無須關注。
transcription.paragraphs[i].words[i].sentenceIdint句子 id,同屬於一個 SentenceId 的 word 資訊可以組裝成一句話。
transcription.paragraphs[i].words[i].startlong該 word 相對於音頻起始時間的開始時間,相對時間戳記,單位毫秒。
transcription.paragraphs[i].words[i].endlong該 word 相對於音頻起始時間的結束時間,相對時間戳記,單位毫秒。
transcription.paragraphs[i].words[i].textstringword 文本。

summarization(全文摘要、發言人總結、提問摘要)

參數名類型說明
summarizationobject摘要結果對象,可能包含 0 個或多個不同摘要類型的結果。
summarization.paragraphSummarystring全文摘要結果。
summarization.conversationalSummarylist[]發言總結摘要結果清單。
summarization.conversationalSummary[i].speakerIdstring發言人 id。
summarization.conversationalSummary[i].speakerNamestring發言人名字。
summarization.conversationalSummary[i].summarystring該發言人對應的總結。
summarization.questionsAnsweringSummarylist[]問答摘要結果清單。
summarization.questionsAnsweringSummary[i].questionstring問題
summarization.questionsAnsweringSummary[i].sentenceIdsOfQuestionlist[]提煉出該問題對應的原語音轉寫的 SentenceId 列表。
summarization.questionsAnsweringSummary[i].answerstring問題對應的答案。
summarization.questionsAnsweringSummary[i].sentenceIdsOfAnswerlist[]總結出該答案對應的原語音轉寫的 SentenceId 列表。
summarization.mindMapSummarylist[object]思維導圖摘要結果清單,可能包含各個主題的摘要、主題間的關係等。
summarization.mindMapSummary[i].titlestring主題的標題。
summarization.mindMapSummary[i].topiclist[object]包含每個主題及其子主題的數組
summarization.mindMapSummary[i].topic[i].titlestring主題的標題。
summarization.mindMapSummary[i].topic[i].topiclist[object]主題的子主題數組,可以是空數組。

translation(全文翻譯)

參數名類型說明
translationobject翻譯結果對象。
translation.paragraphslist[]翻譯結果以段落形式組織的集合,和語音辨識結果報文對應。
translation.paragraphs.paragraphIdstring段落分段 id 標識,和語音辨識結果中的 ParagraphId 對應。
translation.paragraphs.sentenceslist[]翻譯文本集合。
translation.paragraphs.sentences[i].sentenctIdlong句子 id。
translation.paragraphs.sentences[i].startlong該段相對於音頻起始時間的開始時間,相對時間戳記,單位毫秒。
translation.paragraphs.sentences[i].endlong該段相對於音頻起始時間的結束時間,相對時間戳記,單位毫秒。
translation.paragraphs.sentences[i].textstring翻譯文本,和語音辨識結果報文對應。

autoChapters(章節識別)

參數名類型說明
autoChapterslist[]章節預覽集合, 含有 0 個、1 個或多個章節預覽資訊。
autoChapters[i].idint該章節序號。
autoChapters[i].startlong該章節相對於音頻起始時間的開始時間,相對時間戳記,單位毫秒。
autoChapters[i].endlong該章節相對於音頻起始時間的結束時間,相對時間戳記,單位毫秒。
autoChapters[i].headlinestring該章節的一句話標題。
autoChapters[i].summarystring章節總結。

meetingAssistance(智能紀要提取,包含關鍵詞、關鍵句、待辦事項提取)

參數名類型說明
meetingAssistanceobject智能紀要結果對象,可能包含 0 個或多個不同類型的結果。
meetingAssistance.keywordslist[]關鍵詞提取結果。
meetingAssistance.keySentenceslist[]關鍵句提取結果,也稱為重點內容。
meetingAssistance.keySentences[i].idlong關鍵句序號。
meetingAssistance.keySentences[i].sentenceIdlong該關鍵句在原 ASR 轉寫中對應的句子 Id。
meetingAssistance.keySentences[i].startlong相對於音頻起始時間的開始時間,相對時間戳記,單位毫秒。
meetingAssistance.keySentences[i].endlong相對於音頻起始時間的結束時間,相對時間戳記,單位毫秒。
meetingAssistance.keySentences[i].textstring關鍵句資訊。
meetingAssistance.actionslist[]待辦內容、待辦摘要的集合。
meetingAssistance.actions[i].idlong待辦序號。
meetingAssistance.actions[i].sentenceIdlong該關鍵句在原 ASR 轉寫中對應的句子 Id。
meetingAssistance.actions[i].startlong相對於音頻起始時間的開始時間,相對時間戳記,單位毫秒。
meetingAssistance.actions[i].endlong相對於音頻起始時間的結束時間,相對時間戳記,單位毫秒。
meetingAssistance.actions[i].textstring待辦內容。
meetingAssistance.classificationsobject情境分類,目前只有 3 中情境分類。
meetingAssistance.classifications.interviewfloat面試情境信賴度得分。
meetingAssistance.classifications.lecturefloat演講情境信賴度得分。
meetingAssistance.classifications.meetingfloat會議情境信賴度得分。

樣本

正常返回樣本

JSON格式

{
  "JobStatus": "Success",
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "UserData": "{\"userId\":\"123432412831\"}",
  "Results": {
    "Result": [
      {
        "Type": "Meta",
        "Data": "{\"title\":\"example-title-****\"}\t\n"
      }
    ]
  },
  "Usages": {
    "Usage": [
      {
        "Type": "",
        "Quota": 0
      }
    ]
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情