すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:QueryVideoCognitionJob

    ドキュメントセンター

    Intelligent Media Services:QueryVideoCognitionJob

    最終更新日:Apr 13, 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:QueryVideoCognitionJob

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    JobId

    string

    必須

    インテリジェントタギングジョブの ID です。SubmitIntelligentTaggingJob 操作のレスポンスからこの ID を取得できます。

    ****20b48fb04483915d4f2cd8ac****
    Params

    string

    任意

    追加のリクエストパラメーターを JSON 文字列として指定します。

    {}
    IncludeResults

    object

    任意

    レスポンスに含めるアルゴリズム結果を決定するパラメーターのコンテナです。

    NeedAsr

    boolean

    任意

    ASR 結果を返すかどうかを指定します。

    true
    NeedOcr

    boolean

    任意

    OCR 結果を返すかどうかを指定します。

    true
    NeedProcess

    boolean

    任意

    生のオペレーター結果へのリンクを返すかどうかを指定します。

    true

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    JobStatus

    string

    ジョブのステータス。有効な値は次のとおりです：

    • Success：ジョブは成功しました。

    • Fail：ジョブは失敗しました。

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

    • Submitted：ジョブは送信され、処理を待っています。

    Success
    RequestId

    string

    リクエスト ID です。

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

    UserData

    string

    ユーザーデータです。

    {"userId":"123432412831"}

    Results

    object

    result

    array<object>

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

    object

    Type

    string

    分析結果のタイプ。有効な値は次のとおりです。

    1. TextLabel：テキストラベル

    2. VideoLabel：ビデオラベル

    3. ASR：生の ASR 結果（デフォルトでは返されません）

    4. OCR：生の OCR 結果（デフォルトでは返されません）

    5. NLP：生の NLP 結果（デフォルトでは返されません）

    6. Process：生のオペレーター結果への URL（デフォルトでは返されません）

    ASR
    Data

    string

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

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

    TemplateId

    string

    テンプレート ID です。

    Params

    string

    リクエストパラメーターです。

    Input

    object

    入力ファイルです。

    Type

    string

    入力ファイルのタイプ。有効な値：OSS。

    Media

    string

    入力ファイルの URL です。

    結果パラメーター

    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プライマリカテゴリです。例：Lifestyle、Animation、Automotive。
    classifications.category2Stringセカンダリカテゴリです。例えば、プライマリカテゴリが Lifestyle のビデオは、セカンダリカテゴリとして Health や Home を持つことがあります。

    ビデオタグの例

    カテゴリ例
    program例：The Amazing Race、America's Got Talent
    role例：医師、看護師、教師
    object例：ピアノ、カップ、テーブル、車、化粧品、食品
    logo例：CNN、BBC、YouTube、Netflix
    action例：ダンス、キス、ハグ、会議、歌唱、電話、乗馬、格闘
    location例：天安門広場、自由の女神、楽山大仏、中国、米国
    scene例：寝室、地下鉄駅、棚田、ビーチ、砂漠

    ImageLabel データ構造

    パラメータータイプ説明
    personsJSONArray検出された人物です。
    persons.nameString認識された人物の名前です。
    persons.categoryString人物カテゴリです。有効な値は、celebrity (有名人)、politician (政治家)、sensitive person (センシティブな人物) です。
    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信頼度スコアです。

    イメージタグの例

    メインタグ名サブタグ名
    character医師、看護師、教師など
    location天安門広場、自由の女神、楽山大仏、中国、米国など
    action eventスピーチなど
    logoCCTV-1、CCTV-2、Youku、Dragon TV など
    action eventダンス、キス、ハグ、会議、歌唱、電話、乗馬、格闘など
    objectピアノ、カップ、テーブル、トマトと卵の炒め物、車、化粧品など
    scene寝室、地下鉄駅、棚田、ビーチ、砂漠など

    TextLabel データ構造 (ASR および OCR の出力)

    パラメータータイプ説明
    tagsJSONArrayタグの配列です。
    tags.nameStringタグキーです。
    tags.valueStringタグ値です。複数の値はカンマ (,) で区切ります。

    イメージ タグの例

    パラメーター値
    region例：us-east-1、eu-west-2、ap-southeast-1
    organization例：マーケティング部、開発チーム、Acme 社
    identifier例：user-12345、prod-db-01、f7b4c278-6e54-4a8f-8f9d-3e58a9c8b4e7
    keyword例：データベース、課金、エラー

    CPVLabel データ構造

    • cates：カテゴリ (プライマリ、セカンダリ、またはターシャリ) のリストです。

    • entities：知識グラフからの情報を含むカテゴリ属性のリストです。

    • hotwords：人気のある用語のリストです。

    • freeTags：フリータグ (キーワード) のリストです。

    パラメータータイプ値の例説明
    typeStringhmi結果タイプです。有効な値は、hmi (人間と機械の共同作業結果) と autp (自動タグ付け結果) です。
    catesJSONArray-分類結果の配列です。
    cates.labelLevel1StringTravelレベル 1 タグです。
    cates.labelLevel2StringScenic Travelレベル 2 タグです。
    cates.labelString""タグ名です。アルゴリズムが値を返さない場合、このフィールドは空になることがあります。
    cates.appearanceProbabilitydouble0.96出現確率です。
    cates.detailInfoJSONArray-カテゴリの各出現箇所を詳述するオブジェクトの配列です。
    cates.detailInfo.scoredouble0.9信頼度スコアです。
    cates.detailInfo.startTimedouble0.021開始時刻です。
    cates.detailInfo.endTimedouble29.021終了時刻です。
    entitiesJSONArray-検出されたエンティティの配列です。
    entities.labelLevel1Stringlocationレベル 1 タグです。
    entities.labelLevel2Stringlandmarkレベル 2 タグです。
    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.labelLevel1Stringkeywordレベル 1 タグです。
    hotwords.labelLevel1Stringkeywordレベル 1 タグです。
    hotwords.labelLevel2String""レベル 2 タグです。
    hotwords.labelString中国気象局ホットワードです。
    hotwords.appearanceProbabilitydouble0.96出現確率です。
    hotwords.detailInfoJSONArrayホットワードの各出現箇所を詳述するオブジェクトの配列です。
    hotwords.detailInfo.scoredouble1.0信頼度スコアです。
    hotwords.detailInfo.startTimedouble0.021開始時刻です。
    hotwords.detailInfo.endTimedouble29.021終了時刻です。
    freeTagsJSONArray検出されたフリータグの配列です。
    freeTags.labelLevel1Stringkeywordレベル 1 タグです。
    freeTags.labelLevel2String""レベル 2 タグです。
    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認識されたテキストです。

    メタデータアノテーションの結果

    説明

    お客様が SubmitSmarttagJob の呼び出しで手動ラベリングを使用せずに needMetaData を指定した場合、QuerySmarttagJob は元のタイトルを返します。

    パラメータータイプ説明
    titleStringタイトルです。

    サブタイトル

    パラメータータイプ説明
    detailsJSONArray詳細なタスク結果です。
    details.allResultUrlStringすべての字幕結果の URL です。URL はタスク完了後 6 か月間有効です。
    details.chResultUrlString中国語字幕結果の URL です。URL はタスク完了後 6 か月間有効です。
    details.engResultUrlString英語字幕結果の URL です。URL はタスク完了後 6 か月間有効です。
    説明

    字幕結果 URL のコンテンツは、次のフォーマットを使用します： シーケンス番号+期間+字幕コンテンツ (1行に1つの字幕)。

    NLP 結果

    パラメータータイプ説明
    transcriptionobject生成された文字起こしです。
    autoChaptersobject生成されたチャプター概要です。
    summarizationobject生成された大規模モデルの要約です。
    meetingAssistanceobject生成されたインテリジェントな議事録です。
    translationobject生成されたテキスト翻訳です。

    文字起こし

    パラメータータイプ説明
    transcriptionobjecttranscription 結果オブジェクトです。
    transcription.paragraphslist[]文字起こしを構成する paragraph オブジェクトのリストです。
    transcription.paragraphs[i].paragraphIdstringparagraph の ID です。
    transcription.paragraphs[i].speakerIdstringspeaker の ID です。
    transcription.paragraphs[i].wordslist[]paragraph 内の word オブジェクトのリストです。
    transcription.paragraphs[i].words[i].idintword のシーケンス番号です。このフィールドは通常無視できます。
    transcription.paragraphs[i].words[i].sentenceIdintsentence の ID です。同じ sentenceId を持つ単語が文を形成します。
    transcription.paragraphs[i].words[i].startlongword の開始時刻で、ミリ秒単位の相対タイムスタンプです。
    transcription.paragraphs[i].words[i].endlongword の終了時刻で、ミリ秒単位の相対タイムスタンプです。
    transcription.paragraphs[i].words[i].textstringword のテキストです。

    要約 (全文・話者ベース・質問ベース)

    パラメータータイプ説明
    summarizationobject要約結果オブジェクトです。0 個以上の要約タイプの結果を含みます。
    summarization.paragraphSummarystring全文要約です。
    summarization.conversationalSummarylist[]会話要約のリストです。
    summarization.conversationalSummary[i].speakerIdstring話者 ID です。
    summarization.conversationalSummary[i].speakerNamestring話者名です。
    summarization.conversationalSummary[i].summarystringこの話者の要約です。
    summarization.questionsAnsweringSummarylist[]Q&A 要約のリストです。
    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]親トピックのサブトピックの配列です。この配列は空の場合があります。

    翻訳

    パラメータータイプ説明
    translationobject翻訳結果オブジェクトです。
    translation.paragraphslist[]音声認識結果に対応する翻訳された段落のリストです。
    translation.paragraphs.paragraphIdstring段落 ID で、音声認識結果の ParagraphId に対応します。
    translation.paragraphs.sentenceslist[]文オブジェクトのリストです。
    translation.paragraphs.sentences[i].sentenceIdlong文 ID です。
    translation.paragraphs.sentences[i].startlong音声の先頭からの相対的な文の開始時刻 (ミリ秒) です。
    translation.paragraphs.sentences[i].endlong音声の先頭からの相対的な文の終了時刻 (ミリ秒) です。
    translation.paragraphs.sentences[i].textstring翻訳されたテキストで、音声認識結果の文テキストに対応します。

    自動チャプター

    パラメータータイプ説明
    autoChapterslist[]チャプター概要オブジェクトのリストです。
    autoChapters[i].idintチャプター ID です。
    autoChapters[i].startlong音声の先頭からの相対タイムスタンプとしてのチャプターの開始時刻 (ミリ秒) です。
    autoChapters[i].endlong音声の先頭からの相対タイムスタンプとしてのチャプターの終了時刻 (ミリ秒) です。
    autoChapters[i].headlinestringチャプターの見出しです。
    autoChapters[i].summarystringチャプターの要約です。

    meetingAssistance (インテリジェントな会議要約抽出: キーワード、キーセンテンス、アクションアイテム)

    パラメータータイプ説明
    meetingAssistanceobject会議支援結果のコンテナです。このオブジェクトは複数の結果タイプを保持することも、空にすることもできます。
    meetingAssistance.keywordslist[]キーワード抽出結果です。
    meetingAssistance.keySentenceslist[]キーセンテンス抽出結果で、主要コンテンツとも呼ばれます。
    meetingAssistance.keySentences[i].idlongキーセンテンスの ID です。
    meetingAssistance.keySentences[i].sentenceIdlong元の ASR 文字起こしにおける対応する文の ID です。
    meetingAssistance.keySentences[i].startlong音声の先頭からの相対的な開始時刻 (ミリ秒) です。
    meetingAssistance.keySentences[i].endlong音声の先頭からの相対的な終了時刻 (ミリ秒) です。
    meetingAssistance.keySentences[i].textstringキーセンテンスのテキストです。
    meetingAssistance.actionslist[]アクションアイテムとアクションアイテム要約のリストです。
    meetingAssistance.actions[i].idlongアクションアイテムの ID です。
    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会議クラスの信頼度スコアです。

    例

    成功レスポンス

    JSONJSON

    {
  "JobStatus": "Success",
  "RequestId": "******11-DB8D-4A9A-875B-275798******\n",
  "UserData": "{\"userId\":\"123432412831\"}\n",
  "Results": {
    "result": [
      {
        "Type": "ASR",
        "Data": "{\"title\":\"example-title-****\"}\t\n"
      }
    ]
  },
  "TemplateId": "",
  "Params": "",
  "Input": {
    "Type": "",
    "Media": ""
  }
}

    エラーコード

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

    変更履歴

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