すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:SearchMediaByAILabel

    ドキュメントセンター

    Intelligent Media Services:SearchMediaByAILabel

    最終更新日:Mar 21, 2026

    人物名、字幕、AI 分類に基づくマルチモーダル検索を実行できます。

    操作説明

    人物名、字幕、AI 分類に基づくマルチモーダル検索を実行できます。粗検索ではメディアアセット単位の結果が返され、細検索ではメディアアセット内のヒットセグメント情報が返されます。

    今すぐお試しください

    この 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:SearchMediaByAILabel

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    SearchLibName

    string

    任意

    検索ライブラリの名前です。

    test-1
    MediaType

    string

    任意

    メディアアセットのタイプです。有効な値は以下のとおりです。

    • image

    • video

    • audio

    列挙値:

    • image :

      image

    • video :

      video

    • audio :

      audio

    video
    SortBy

    string

    任意

    結果の並べ替え方法です。有効な値は以下のとおりです。

    • CreationTime:Desc（デフォルト）：作成時刻の降順（新しい順）で並べ替えます。

    • CreationTime:Asc：作成時刻の昇順（古い順）で並べ替えます。

    CreationTime:Desc

    PageNo

    integer

    任意

    ページ番号です。デフォルト値は 1 です。

    1
    PageSize

    integer

    任意

    1 ページあたりの表示件数です。デフォルト値は 10、最大値は 50 です。

    20
    Text

    string

    任意

    検索対象のコンテンツです。

    风筝
    MultimodalSearchType

    string

    任意

    クエリのタイプです。有効な値は以下のとおりです。

    • PersonName：人物名に基づいてメディアアセットを検索します。

    • Ocr：字幕に基づいてメディアアセットを検索します。

    • AiCategory：AI カテゴリに基づいてメディアアセットを検索します。

    • FullSearch（デフォルト）：すべてのメディアアセットを検索します。

    列挙値:

    • PersonName :

      PersonName

    • AiCategory :

      AiCategory

    • FullSearch :

      FullSearch

    • Ocr :

      Ocr

    Ocr
    SpecificSearch

    boolean

    任意

    メディアアセットのクリップを検索するかどうかを指定します。有効な値は以下のとおりです。

    • true

    • false

    true
    MediaId

    string

    任意

    メディアアセットの ID です。メディアアセットのクリップを検索する場合、このパラメーターは必須です。

    ****c469e944b5a856828dc2****

    MatchingMode

    string

    任意

    マッチングパターンです。「fuzzy」（あいまい検索）がデフォルト値です。有効な値は以下のとおりです。

    • fuzzy：あいまい検索

    • precise：正確検索。このパターンは新規追加されたメディアアセットにのみ適用されます。

    列挙値:

    • precise :

      precise

    • fuzzy :

      fuzzy

    fuzzy
    Namespace

    string

    任意

    ネームスペースです。

    name-1
    CustomFilters

    string

    任意

    カスタムフィルターです。JSON 文字列形式で指定します。サポートされるバッキングフィールドは以下のとおりです：intField1（整数型）、strField1 および strField2（文字列型）。同一フィールドに対しては、1 つのマッチング方式のみ指定可能です。異なるフィールドのフィルターは論理積（AND）で結合されます。

    • 完全一致例：{"intField1":12,"strField1":"abc"}

    • 複数値一致例：{"intField1":[12,13],"strField1":["abc","cd"]}

    • 範囲一致例：{"intField1":{"gte":12,"lte":13}}

    {"intField1":{"gte":12,"lte":13},"strField2":["cd","de"],"strField1":"abc"}
    UtcCreate

    string

    任意

    作成時刻（UNIX タイムスタンプ、ミリ秒単位）。gte は「以上」、lte は「以下」を意味します。

    • 範囲指定例：{"gte":1761205662998,"lte":1771205662998}

    {"gte":1761205662998,"lte":1771205662998}

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答のスキーマです。

    RequestId

    string

    リクエストの ID です。

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

    string

    リクエストが成功したかどうかを示します。

    true
    Code

    string

    返された状態コードです。

    200
    MediaList

    array<object>

    指定されたコンテンツを含むメディアアセットです。

    array<object>

    メディアアセットに関する情報です。

    AiData

    object

    AI ジョブの詳細です。

    AiLabelInfo

    array<object>

    AI ジョブのタグです。

    array<object>

    AI タグに関する情報です。

    FaceId

    string

    顔の ID です。

    5FE19530C7A422197535FE74F5DB****

    LabelType

    string

    タグのタイプです。

    物体
    Source

    string

    ソースです。

    vision
    Category

    string

    カテゴリです。

    交通工具
    LabelName

    string

    エンティティの名前です。

    车
    LabelId

    string

    エンティティの ID です。

    103102503**
    Occurrences

    array<object>

    クリップに関する情報です。

    array<object>

    クリップに関する情報です。

    Score

    number

    スコアです。

    0.75287705

    Image

    string

    最も顔情報を含む画像です。

    https://service-****-public.oss-cn-hangzhou.aliyuncs.com/1563457****438522/service-image/f788974f-9595-43b2-a478-7c7a1afb****.jpg
    TableBatchSeqId

    string

    ベクターテーブルのシーケンス ID です。

    85010D1**
    ClipId

    string

    クリップの ID です。

    158730355E4B82257D8AA1583A58****
    From

    number

    クリップの開始時刻です。

    1.4
    To

    number

    クリップの終了時刻です。

    2.5
    FinegrainName

    string

    エンティティの詳細名です。

    车
    FinegrainId

    string

    エンティティの詳細 ID です。

    103102503**
    Content

    string

    テキストの内容です。

    智能标签测试

    Tracks

    array<object>

    トラックです。

    object

    トラックです。

    Size

    number

    バウンディングボックスのサイズです。

    50
    Position

    string

    バウンディングボックスの座標です。

    468.0;67.0;615.0;267.0
    Timestamp

    number

    トラックのタイムスタンプです。

    1.4
    AsrInfo

    array<object>

    音声ファイルに関する情報です。

    object

    音声ファイルに関する情報です。

    From

    number

    クリップの開始時刻です。

    1.4
    To

    number

    クリップの終了時刻です。

    2.5
    ClipId

    string

    クリップの ID です。

    5FE19530C7A422197535FE74F5DB****
    Content

    string

    音声の内容です。

    智能标签测试
    Timestamp

    number

    クリップのタイムスタンプです。

    1.4
    OcrInfo

    array<object>

    字幕ファイルに関する情報です。

    object

    字幕ファイルに関する情報です。

    From

    number

    クリップの開始時刻です。

    1.4
    To

    number

    クリップの終了時刻です。

    2.5
    ClipId

    string

    クリップの ID です。

    5FE19530C7A422197535FE74F5DB****

    Content

    string

    テキストの内容です。

    皮皮
    Timestamp

    number

    クリップのタイムスタンプです。

    1.4
    StorageLocation

    string

    ストレージの場所です。

    out-****.oss-cn-shanghai.aliyuncs.com

    Status

    string

    動画のステータスです。

    有効な値は以下のとおりです。

    • PrepareFail

    • UploadFail

    • Init

    • UploadSucc

    • Transcoding

    • TranscodeFail

    • Deleted

    • Normal

    • Uploading

    • Preparing

    • Blocked

    • Checking

    列挙値:

    • PrepareFail :

      PrepareFail

    • UploadFail :

      UploadFail

    • Init :

      Init

    • UploadSucc :

      UploadSucc

    • Transcoding :

      Transcoding

    • TranscodeFail :

      TranscodeFail

    • Deleted :

      Deleted

    • Normal :

      Normal

    • Uploading :

      Uploading

    • Preparing :

      Preparing

    • Blocked :

      Blocked

    • Checking :

      Checking

    Normal
    CreationTime

    string

    メディアアセットが作成された時刻です。ISO 8601 標準（yyyy-MM-ddTHH:mm:ssZ 形式）に従い、UTC 表示となります。

    2017-11-14T09:15:50Z

    ModificationTime

    string

    メディアアセットが更新された時刻です。ISO 8601 標準（yyyy-MM-ddTHH:mm:ssZ 形式）に従い、UTC 表示となります。

    2017-11-14T09:15:50Z

    MediaId

    string

    メディアアセットの ID です。

    1c6ce34007d571ed94667630a6bc****

    Tags

    string

    メディアアセットのタグです。

    标签1, 标签2

    Description

    string

    メディアアセットの説明です。

    阿里云VOD视频描述

    AppId

    string

    アプリケーションの ID です。デフォルト値は app-1000000 です。

    app-1000000
    Size

    integer

    ソースファイルのサイズです。単位：バイト。

    10897890
    CoverUrl

    string

    サムネイルの URL です。

    http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****
    Duration

    number

    持続時間です。単位：秒。

    12.2
    Title

    string

    メディアアセットのタイトルです。

    史上最牛音乐播放器

    Snapshots

    array

    ビデオスナップショットの URL 配列です。

    string

    ビデオスナップショットの URL です。

    http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****
    Total

    integer

    条件に合致する音声および動画ファイルの総数です。

    30

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "Success": "true",
  "Code": "200",
  "MediaList": [
    {
      "AiData": {
        "AiLabelInfo": [
          {
            "FaceId": "5FE19530C7A422197535FE74F5DB****\n",
            "LabelType": "物体",
            "Source": "vision",
            "Category": "交通工具",
            "LabelName": "车",
            "LabelId": "103102503**",
            "Occurrences": [
              {
                "Score": 0.75287705,
                "Image": "https://service-****-public.oss-cn-hangzhou.aliyuncs.com/1563457****438522/service-image/f788974f-9595-43b2-a478-7c7a1afb****.jpg",
                "TableBatchSeqId": "85010D1**",
                "ClipId": "158730355E4B82257D8AA1583A58****",
                "From": 1.4,
                "To": 2.5,
                "FinegrainName": "车",
                "FinegrainId": "103102503**",
                "Content": "智能标签测试\n",
                "Tracks": [
                  {
                    "Size": 50,
                    "Position": "468.0;67.0;615.0;267.0",
                    "Timestamp": 1.4
                  }
                ]
              }
            ]
          }
        ],
        "AsrInfo": [
          {
            "From": 1.4,
            "To": 2.5,
            "ClipId": "5FE19530C7A422197535FE74F5DB****",
            "Content": "智能标签测试",
            "Timestamp": 1.4
          }
        ],
        "OcrInfo": [
          {
            "From": 1.4,
            "To": 2.5,
            "ClipId": "5FE19530C7A422197535FE74F5DB****\n",
            "Content": "皮皮",
            "Timestamp": 1.4
          }
        ]
      },
      "StorageLocation": "out-****.oss-cn-shanghai.aliyuncs.com\n",
      "Status": "Normal",
      "CreationTime": "2017-11-14T09:15:50Z\n",
      "ModificationTime": "2017-11-14T09:15:50Z\n",
      "MediaId": "1c6ce34007d571ed94667630a6bc****\n",
      "Tags": "标签1, 标签2\n",
      "Description": "阿里云VOD视频描述\n",
      "AppId": "app-1000000",
      "Size": 10897890,
      "CoverUrl": "http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****",
      "Duration": 12.2,
      "Title": "史上最牛音乐播放器\n",
      "Snapshots": [
        "http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****"
      ]
    }
  ],
  "Total": 30
}

    エラーコード

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

    変更履歴

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