すべてのプロダクト
Search
ドキュメントセンター

Intelligent Media Services:QuerySmarttagJob

最終更新日:Jun 05, 2026

スマートタグタスクをクエリします。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ice:QuerySmarttagJob

get

* すべてのリソース

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

JobId

string

必須

スマートタギングジョブの ID。この ID は、SubmitSmarttagJob の呼び出しの応答から取得できます。

88c6ca184c0e47098a5b665e2****

Params

string

任意

追加のリクエストパラメーター。JSON 文字列形式で指定します。例: {"labelResultType":"auto"}labelResultType パラメーターは、次の値をサポートします:

  • auto:機械生成のタギング結果

  • hmi:ヒューマンインザループのタギング結果

{"labelResultType":"auto"}

レスポンスフィールド

フィールド

説明

オブジェクト

JobStatus

文字列

ジョブステータス。有効な値:

  • Success:ジョブは成功です。

  • Fail:ジョブは失敗です。

  • Processing:ジョブは処理中です。

  • Submitted:ジョブは送信済みであり、処理のためキューに入っています。

Success

RequestId

文字列

リクエスト ID。

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

UserData

文字列

MNS コールバックで渡されるカスタムデータです。メッセージフォーマットの詳細については、後述のコールバックメッセージフォーマットの定義をご参照ください。

{"userId":"123432412831"}

Results

オブジェクト

Result

配列<オブジェクト>

分析結果オブジェクトの配列。

オブジェクト

Type

文字列

分析結果のタイプ。

  • - タギング v1.0 の分析結果タイプ:

  1. TextLabel:テキストラベル

  2. VideoLabel:ビデオラベル

  3. ASR:自動音声認識の未加工の結果。デフォルトでは返されません。

  4. OCR:光学文字認識の未加工の結果。デフォルトでは返されません。

  5. NLP:自然言語処理の結果。デフォルトでは返されません。

  • - タギング v2.0 の分析結果タイプ:

  1. CPVLabel

  2. Meta:ビデオタイトルなどのメタデータ。デフォルトでは返されません。

  • - タギング v2.0-custom の分析結果タイプ:

  1. CPVLabel

  2. Meta:ビデオタイトルなどのメタデータ。デフォルトでは返されません。

Meta

Data

文字列

JSON 文字列形式の分析結果データ。データ構造は Type の値によって異なります。詳細については、「後述の Result パラメーターの説明」をご参照ください。

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

Usages

オブジェクト

Usage

配列<オブジェクト>

オブジェクト

Type

文字列

Quota

整数

コールバックメッセージのフォーマット スマートタグジョブの実行ステータスが変更されると、MPS は MPS UpdatePipeline API で指定したキューにコールバックメッセージを送信します。メッセージ本文は、次のフィールドを含む JSON 文字列です:

パラメータータイプ説明
Type文字列値が smarttag の固定文字列であり、スマートタグジョブを示します。
JobId文字列ジョブの一意の ID です。
State文字列ジョブの現在の状態です。この値は、QuerySmarttagJob API が返す JobStatus と一致します。
UserData文字列SubmitSmarttagJob API に渡されるユーザーデータです。

結果パラメーター

VideoLabel データ構造

パラメータータイプ説明
personsJSONArray検出された人物をそれぞれ表すオブジェクトの配列です。
persons.name文字列認識された人物の名前です。
persons.category文字列人物のカテゴリです。 指定できる値は celebritypoliticiansensitive (センシティブな人物)、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.scene文字列ショットタイプです。 指定できる値は closeUp (クローズアップショット)、medium-closeUp (ミディアムクローズアップショット)、medium (ミディアムショット)、medium-long (ミディアムロングショット) です。
tagsJSONArrayオブジェクトやシーンなど、検出されたタグを表すオブジェクトの配列です。 例については、以下の表をご参照ください。
tags.mainTagName文字列メインタグです。
tags.subTagName文字列サブタグです。
tags.ratiodoubleタグの出現比率です。 値の範囲は 0~1 です。
tags.occurrencesJSONArrayタグの各出現を詳述するオブジェクトの配列です。
tags.occurrences.scoredoubleタグの信頼度スコアです。
tags.occurrences.fromdouble出現開始時刻です (単位:秒)。
tags.occurrences.todouble出現終了時刻です (単位:秒)。
classificationsJSONArray各動画分類を表すオブジェクトの配列です。
classifications.scoredouble分類の信頼度スコアです。
classifications.category1文字列Lifestyle、Anime、Automotive などのレベル 1 カテゴリです。
classifications.category2文字列レベル 2 のカテゴリで、レベル 1 カテゴリのサブカテゴリです。 例えば、Lifestyle カテゴリには Health や Home などのサブカテゴリが含まれます。

ビデオタグの例

タグ
番組「パパはどこへ行く?」、「トップお笑い芸人」
キャラクター医者、看護師、教師
オブジェクトピアノ、カップ、テーブル、トマトと卵の炒め物、車、化粧品
ロゴCCTV-1、CCTV-2、Youku、Dragon TV
アクションダンス、キス、抱擁、会合、歌唱、通話、乗馬、格闘
ロケーション天安門広場、自由の女神、楽山大仏、中国、アメリカ合衆国
シーン寝室、地下鉄の駅、棚田、ビーチ、砂漠

ImageLabel のデータ構造

パラメータータイプ説明
personsJSONArray検出された各人物を表すオブジェクトの配列です。
persons.name文字列認識された人物の名前。
persons.category文字列人物のカテゴリ。有効な値は celebritypoliticiansensitive です。
persons.scoredouble検出された人物の信頼度スコア。
persons.positionJSONObject顔の座標。
persons.position.leftTopint[]バウンディングボックスの左上隅のx座標とy座標。
persons.position.rightBottomint[]バウンディングボックスの右下隅のx座標とy座標。
persons.scene文字列ショット。有効な値は、closeUp (クローズアップ)、medium-closeUp (ミディアムクローズアップ)、medium (ミディアムショット)、medium-long (ミディアムロングショット) です。
tagsJSONArray検出されたオブジェクトとシーンのタグ。詳細については、以下の表の例をご参照ください。
tags.mainTagName文字列メインタグ。
tags.subTagName文字列サブタグ。
tags.scoredoubleタグの信頼度スコア。

イメージタグの例

メインタグサブタグ
キャラクター例:医者、看護師、教師
ロケーション例:天安門広場、自由の女神、楽山大仏、中国、アメリカ合衆国
アクション例:話す
ロゴ例:CCTV1、CCTV2、Youku、Dragon TV
アクション例:踊る、キスする、抱きしめる、会う、歌う、電話をかける、乗馬する、戦う
オブジェクト例:ピアノ、カップ、テーブル、トマトと卵炒め、車、化粧品
シーン例:寝室、地下鉄の駅、棚田、ビーチ、砂漠

テキストラベルのデータ構造(ソース: ASR および OCR)

パラメータータイプ説明
tagsJSONArrayリソースのタグのリスト。
tags.name文字列タグのキー。
tags.value文字列タグの値。複数の値はカンマで区切ります。

イメージタグの例

パラメーター
地域例:東京タワー、自由の女神、富士山、日本、アメリカ合衆国
組織例:世界自然保護基金、日本放送協会
ロゴ例:ナイキ、トヨタ
キーワード例:コアストレングス

CPVLabel データ構造

  • cates :階層カテゴリ (例:レベル 1、レベル 2、レベル 3)。

  • entities :カテゴリ属性 (知識グラフ情報により強化)。

  • hotwords :人気キーワード (ユーザーの関心を反映する用語)。

  • freeTags :自由形式タグ (ユーザー定義キーワード)。

パラメータータイプサンプル値説明
type文字列hmi結果タイプです。有効な値: hmi (ヒューマンマシンインタラクションの結果)、 autp (自動タグ付けの結果)。
catesJSONArray-カテゴリ分類の結果です。
cates.labelLevel1文字列Travelレベル 1 ラベルです。
cates.labelLevel2文字列Travel Sceneryレベル 2 ラベルです。
cates.label文字列""ラベル名です。アルゴリズムが空の文字列を返す場合があります。
cates.appearanceProbabilitydouble0.96出現確率です。
cates.detailInfoJSONArray-カテゴリの詳細情報です。
cates.detailInfo.scoredouble0.9信頼度スコアです。
cates.detailInfo.startTimedouble0.021開始時刻です。
cates.detailInfo.endTimedouble29.021終了時刻です。
entitiesJSONArray-検出されたエンティティです。
entities.labelLevel1文字列Regionレベル 1 ラベルです。
entities.labelLevel2文字列Landmarkレベル 2 ラベルです。
entities.label文字列Huangguoshu Waterfallラベル名です。
entities.appearanceProbabilitydouble0.067出現確率です。
entities.knowledgeInfo文字列{"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.labelLevel1文字列keywordレベル 1 ラベルです。
hotwords.labelLevel2文字列""レベル 2 ラベルです。
hotwords.label文字列中国气象局ホットワードの内容です。
hotwords.appearanceProbabilitydouble0.96出現確率です。
hotwords.detailInfoJSONArray-ホットワードの詳細情報です。
hotwords.detailInfo.scoredouble1.0信頼度スコアです。
hotwords.detailInfo.startTimedouble0.021開始時刻です。
hotwords.detailInfo.endTimedouble29.021終了時刻です。
freeTagsJSONArray-フリーフォームタグです。
freeTags.labelLevel1文字列keywordレベル 1 ラベルです。
freeTags.labelLevel2文字列""レベル 2 ラベルです。
freeTags.label文字列中央气象台タグの内容です。
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 結果

パラメーターType説明
detailsJSONArrayタスク詳細を含むオブジェクトの配列。
details.timestampdouble秒単位のタイムスタンプ。
details.infoJSONArray対応するタイムスタンプの認識情報をそれぞれ含むオブジェクトの配列。
details.info.scoredouble信頼度スコア。
details.info.positionJSONObjectテキストの座標。
details.info.position.leftTopint[]左上隅の座標。
details.info.position.rightBottomint[]右下隅の座標。
details.info.content文字列認識されたテキスト内容。

メタアノテーション結果

説明

人間によるアノテーションを使用せず、SubmitSmarttagJob でタスクを送信する際に needMetaData パラメーターを指定した場合、QuerySmarttagJob は入力した title をそのまま返します。

パラメータータイプ説明
title文字列タイトル。

字幕抽出結果

パラメータータイプ説明
detailsObjectタスクの詳細な結果。
details.allResultUrl文字列すべての字幕結果の URL。タスク完了後、6か月間有効です。
details.chResultUrl文字列中国語字幕結果の URL。タスク完了後、6か月間有効です。
details.engResultUrl文字列英語字幕結果の URL。タスク完了後、6か月間有効です。
説明

字幕結果の URL は、次のフォーマットでコンテンツを返します: シーケンス番号 + 時間範囲 + 字幕内容 (1 行につき 1 つの字幕)

NLP 結果

パラメータータイプ説明
transcriptionobjectトランスクリプション。
autoChaptersobject自動生成されたチャプター。
summarizationobject大規模モデルが生成したサマリー。
meetingAssistanceobjectインテリジェントな議事録。
translationobject翻訳されたテキスト。

文字起こし

パラメータータイプ説明
transcriptionobject音声文字起こしの結果です。
transcription.paragraphslist[]音声文字起こしにおけるパラグラフのリストです。
transcription.paragraphs[i].paragraphId文字列パラグラフの ID です。
transcription.paragraphs[i].speakerId文字列スピーカー ID です。
transcription.paragraphs[i].wordslist[]パラグラフ内の単語のリストです。
transcription.paragraphs[i].words[i].idint単語のシーケンス番号です。通常、このフィールドは無視できます。
transcription.paragraphs[i].words[i].sentenceIdint文 ID です。同じ sentenceId を持つ単語が 1 つの文を構成します。
transcription.paragraphs[i].words[i].startlongオーディオの先頭を基準とした、単語の開始時刻です (単位:ミリ秒)。
transcription.paragraphs[i].words[i].endlongオーディオの先頭を基準とした、単語の終了時刻です (単位:ミリ秒)。
transcription.paragraphs[i].words[i].text文字列単語のテキストです。

要約:全文要約、話者要約、質問要約

パラメーターType説明
summarizationobject複数の要約タイプの結果を含むことができる、要約結果のオブジェクトです。
summarization.paragraphSummary文字列段落要約の結果です。
summarization.conversationalSummarylist[]会話要約の結果のリストです。
summarization.conversationalSummary[i].speakerId文字列話者の ID です。
summarization.conversationalSummary[i].speakerName文字列話者名です。
summarization.conversationalSummary[i].summary文字列話者の要約です。
summarization.questionsAnsweringSummarylist[]質疑応答要約の結果のリストです。
summarization.questionsAnsweringSummary[i].question文字列音声書き起こしから抽出された質問です。
summarization.questionsAnsweringSummary[i].sentenceIdsOfQuestionlist[]質問を構成する、元の音声書き起こしの文の ID のリストです。
summarization.questionsAnsweringSummary[i].answer文字列質問への回答です。
summarization.questionsAnsweringSummary[i].sentenceIdsOfAnswerlist[]回答として要約される、元の音声書き起こしの文の ID のリストです。
summarization.mindMapSummarylist[object]トピックの要約とその関係を含む場合がある、マインドマップ要約の結果のリストです。
summarization.mindMapSummary[i].title文字列マインドマップのタイトルです。
summarization.mindMapSummary[i].topiclist[object]サブトピックをそれぞれ含むメイントピックのリストです。
summarization.mindMapSummary[i].topic[i].title文字列メイントピックのタイトルです。
summarization.mindMapSummary[i].topic[i].topiclist[object]現在のトピックのサブトピックのリストです。空の場合があります。

全文翻訳

パラメータータイプ説明
translationオブジェクト翻訳オブジェクトです。
translation.paragraphsリスト音声認識結果に対応する、翻訳された段落のリストです。
translation.paragraphs.paragraphId文字列音声認識結果の ParagraphId に対応する段落 ID です。
translation.paragraphs.sentencesリスト段落を構成する文のリストです。
translation.paragraphs.sentences[i].sentenceIdlong一意な文 ID です。
translation.paragraphs.sentences[i].startlong音声の先頭を基準とした、文の開始時刻 (ミリ秒単位) です。
translation.paragraphs.sentences[i].endlong音声の先頭を基準とした、文の終了時刻 (ミリ秒単位) です。
translation.paragraphs.sentences[i].text文字列翻訳された文のテキストです。

オートチャプター (チャプター認識)

パラメータータイプ説明
autoChaptersリスト[]チャプター概要オブジェクトのリストです。
autoChapters[i].idintチャプター ID です。
autoChapters[i].startlongチャプターの開始時間。オーディオの開始からの相対タイムスタンプ (単位:ミリ秒) で表されます。
autoChapters[i].endlongチャプターの終了時間。オーディオの開始からの相対タイムスタンプ (単位:ミリ秒) で表されます。
autoChapters[i].headline文字列チャプターのヘッドラインです。
autoChapters[i].summary文字列チャプターの要約です。

ミーティングアシスタンス (要約、キーワード、キーセンテンス、アクションアイテムの抽出)

パラメータータイプ説明
meetingAssistanceオブジェクトインテリジェント議事録の結果オブジェクトです。さまざまなタイプの結果が 0 個以上含まれる場合があります。
meetingAssistance.keywordsリストキーワード抽出の結果です。
meetingAssistance.keySentencesリストキーセンテンス抽出の結果です。キーコンテンツとも呼ばれます。
meetingAssistance.keySentences[i].id長整数キーセンテンスの ID です。
meetingAssistance.keySentences[i].sentenceId長整数元の ASR 文字起こし内の、対応する文の ID です。
meetingAssistance.keySentences[i].start長整数オーディオの先頭を基準とした、ミリ秒単位の開始時刻です。
meetingAssistance.keySentences[i].end長整数オーディオの先頭を基準とした、ミリ秒単位の終了時刻です。
meetingAssistance.keySentences[i].text文字列キーセンテンスのテキストです。
meetingAssistance.actionsリストアクションアイテムのリストです。
meetingAssistance.actions[i].id長整数アクションアイテムの ID です。
meetingAssistance.actions[i].sentenceId長整数元の ASR 文字起こし内の、対応する文の ID です。
meetingAssistance.actions[i].start長整数オーディオの先頭を基準とした、ミリ秒単位の開始時刻です。
meetingAssistance.actions[i].end長整数オーディオの先頭を基準とした、ミリ秒単位の終了時刻です。
meetingAssistance.actions[i].text文字列アクションアイテムのテキストです。
meetingAssistance.classificationsオブジェクトシーン分類の結果です。現在、3 つのシーンタイプのみをサポートしています。
meetingAssistance.classifications.interview浮動小数点数インタビューシーンの信頼度スコアです。
meetingAssistance.classifications.lecture浮動小数点数講演シーンの信頼度スコアです。
meetingAssistance.classifications.meeting浮動小数点数会議シーンの信頼度スコアです。

成功レスポンス

JSONJSON

{
  "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
      }
    ]
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。